v50

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

Get specification values by subcollection ID

Retrieves specification values searching by subcollection 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:

ProductCategoryResource
Catalog APIGeneralView Category

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/pvt/subcollection/{subCollectionId}/specificationvalue

Path parameters

subCollectionIdinteger required
Example:80

Subcollection unique numerical identifier, which can be obtained by placing a request to Get subcollection by collection ID.

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

OK

Pageinteger

Current page number of the result set.

Sizeinteger

Number of records per page.

TotalRowsinteger

Total number of records returned.

TotalPageinteger

Total number of pages available.