For AI agents: markdown of this page — /docs-content-en/entities/catalog-skus/get.md documentation index — /llms.txt

Get an SKU

GET /v1/catalog-skus/:id

Returns a single parent product by identifier. The response contains more fields than the list: in addition to the fields from the field reference, it returns the array of sections and the catalog properties.

Parameters

Parameter Type Required Description
id (path) number yes Parent product identifier. List: GET /v1/catalog-skus

Examples

curl — personal key

Terminal 
curl "https://vibecode.bitrix24.com/v1/catalog-skus/7205" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl "https://vibecode.bitrix24.com/v1/catalog-skus/7205" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/catalog-skus/7205', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Parent product:', data.name, 'type:', data.type)

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/catalog-skus/7205', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Response fields

Field Type Description
success boolean Always true on success
data object Parent product object. Field set — see SKU fields

A single record contains all fields from the field reference, including those the list returns only via select: code, xmlId, sort, texts, and pictures. It also returns:

  • iblockSection — an array of IDs of all sections the product is linked to, or null
  • catalog properties of the form propertyNNN, where NNN is the property id from GET /v1/catalog-product-properties. A string property arrives as an object { value, valueId }, a checkbox as the string "Y" or "N"

Fields with an empty value are returned as null.

Response example

The main fields are shown; propertyNNN properties are omitted.

JSON 
{
  "success": true,
  "data": {
    "id": 7205,
    "iblockId": 25,
    "iblockSectionId": 19,
    "iblockSection": [19],
    "name": "Basic hoodie",
    "type": 3,
    "active": true,
    "available": true,
    "bundle": false,
    "code": null,
    "xmlId": "7205",
    "sort": 500,
    "previewText": null,
    "previewTextType": "text",
    "detailText": null,
    "detailTextType": "text",
    "previewPicture": null,
    "detailPicture": null,
    "dateActiveFrom": null,
    "dateActiveTo": null,
    "createdBy": 1295,
    "modifiedBy": 1295,
    "dateCreate": "2026-10-08T18:45:34.000Z",
    "timestampX": "2026-10-08T18:45:36.000Z"
  }
}

Error response example

404 — no parent product with this id exists:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "sku does not exist."
  }
}

Errors

HTTP Code Description
404 ENTITY_NOT_FOUND No product with the specified id exists (sku does not exist.)
404 ENTITY_NOT_FOUND The id belongs to a product that is not a parent product: a regular product or an offer (catalogSku <id> not found)
403 SCOPE_DENIED The API key does not have the catalog scope
401 MISSING_API_KEY The X-Api-Key header was not passed

Full list of common API errors — Errors.

Known specifics

After its last offer is deleted, the product is no longer a parent product. Bitrix24 converts it to a regular product with type: 1, and a request by its id returns 404 ENTITY_NOT_FOUND with the message catalogSku <id> not found. The product stays in the catalog and can be read through GET /v1/catalog-products/:id.

See also