v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-29208421.4 MB

SKU

Get SKU list by product ID

Retrieves a list with the SKUs related to a product by the product's ID.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:

Product	Category	Resource
Catalog	Content	SKUs

There are no applicable predefined roles for this resource list. You must create a custom role and add at least one of the resources above in order to use this endpoint. To learn more about machine authentication at VTEX, see Authentication overview.

❗ To prevent integrations from having excessive permissions, consider the best practices for managing API keys when assigning License Manager roles to integrations.

get/api/catalog_system/pvt/sku/stockkeepingunitByProductId/{productId}

Path parameters

productIdinteger required

Example:1

Product's unique numerical identifier.

Headers

Content-Typestring required

Type of the content being sent.

Acceptstring required

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Response

IsPersistedboolean

Defines if the SKU is persisted.

IsRemovedboolean

Defines if the SKU is removed.

Idinteger

SKU ID.

ProductIdinteger

Product ID.

IsActiveboolean

Defines if the SKU is active or not.

Namestring

SKU name.

Heightnumber

SKU height.

RealHeightnumber nullable

Real SKU height.

Widthnumber

SKU width.

RealWidthnumber nullable

Real SKU width.

Lengthnumber

SKU length.

RealLengthnumber nullable

Real SKU length.

WeightKgnumber nullable

Weight of the SKU in the measurement configured in the store, which by default is in grams.

RealWeightKgnumber nullable

Real weight of the SKU in the measurement unit configured in the store, which by default is in grams.

ModalIdinteger

Delivery method (modal type) ID.

RefIdstring

Product reference ID.

CubicWeightnumber

Cubic weight.

IsKitboolean

Defines whether the SKU is made up of one or more SKUs (part of a kit) (true) or not (false). Must be enabled if you are adding a kit. Once activated, this definition cannot be reverted.

IsDynamicKitstring nullable

Deprecated field.

InternalNotestring nullable

Internal note.

DateUpdatedstring

Date when the product was updated for the most recent time.

RewardValuenumber nullable

Credit that the customer receives when finalizing an order that includes the SKU. By filling this field out with 1, the customer receives credit on the site in the selected currency, e.g. U$ 1.

CommercialConditionIdinteger

Commercial condition ID, used to define SKU specific promotions or installment rules. In case of no specific condition, use 1 (default value). This field does not accept 0. Learn more at Registering a commercial condition.

EstimatedDateArrivalstring nullable

SKU estimated arrival date in ISO-8601 format, when the product is on pre-sale. You must take into consideration both the launch date and the freight calculation for the arrival date.

FlagKitItensSellApartboolean

Defines if the SKU bundle items can be sold separately.

ManufacturerCodestring

Identifier provided by the manufacturers to identify their product. This field should be filled in if the product has a specific manufacturer's code.

ReferenceStockKeepingUnitIdstring nullable

SKU reference ID.

Positioninteger

SKU position.

ActivateIfPossibleboolean

When set to true, this attribute will automatically update the SKU as active once associated with an image or an active component.

MeasurementUnitstring

Measurement unit. This field should only be used when it is necessary to convert the unit of measure for sale. For example, if a product is sold in boxes, but customers want to buy per square meter (m²). In common cases, use "un".

UnitMultipliernumber

Multiple number of SKU. If the multiplier is 5.0000, the product can be added in multiple quantities of 5, 10, 15, 20, onward.

IsInventoriedboolean nullable

Deprecated field.

IsTransportedboolean nullable

Deprecated field.

IsGiftCardRechargeboolean nullable

Defines if the purchase of the SKU will generate reward value for the customer.

ModalTypestring nullable

Links an unusual type of SKU that needs special transportation, such as meat, glass, or a mattress, to a carrier specialized in delivering it. This field should be filled in with the name of the modal (e.g. "Chemicals" or "Refrigerated products"). To learn more about this feature, read our articles How the modal works and Setting up modal for carriers.

isKitOptimizedboolean

Defines if the SKU is an optimized bundle.