Size chart requirements
Tells whether a category asks for a size chart.
Read size chart requirements
- MockDevelopment only
- Mercado LivreNot supported
- MagaluPlanned
- AmazonPlanned
- TikTok ShopPlanned
- ShopeePlanned
Send categoryId and read the support field:
support | What it means |
|---|---|
unsupported | the category has no size chart |
optional | the category accepts a size chart |
required | a listing without a size chart is refused |
curl "$BACKEND_URL/v1/connections/$CONNECTION_ID/size-chart-requirements?categoryId=mock-tshirts" \
-H "Authorization: Bearer mk_your_api_key"When there is a chart, measurements lists the measures of each row, with key, label, unit and required (whether every row needs it). With unsupported, the list is empty.
Measures come in the API canonical unit: length in mm and weight in g (unit uses UCUM). The adapter converts from what the marketplace uses, such as cm.
Creating or editing the chart has no common model: use a native operation.
Part of Publish listings. Synchronous read, no Job, as in List categories.
api_keyAuthorizationBearer <token>API key (mk_...)
id*stringIdentifier of the resource, as returned by the API.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidcategoryId*stringThe category to describe.
1 <= length <= 200Whether the category takes a size chart (support) and the measurements a row carries.
application/json- response
Whether a category takes a size chart, and what it carries.
categoryId*stringThe category these requirements are for.
1 <= length <= 200support*stringunsupported: the category takes no size chart. optional: it takes one. required: a listing without one is refused.
"unsupported""optional""required"measurements*array<>The measurements a chart row carries, each with its key, label, UCUM unit and whether every row needs it (required). Empty when support is unsupported.
items <= 50marketplaceData*The marketplace native value for this item, without personal data. Its shape is the marketplace own and may change without notice: use the canonical fields and keep this for support.
curl -X GET "https://example.com/v1/connections/3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01/size-chart-requirements?categoryId=mock-tshirts"{ "categoryId": "mock-tshirts", "support": "required", "measurements": [ { "key": "CHEST", "label": "Chest", "unit": "mm", "required": true }, { "key": "LENGTH", "label": "Length", "unit": "mm", "required": false } ], "marketplaceData": {}}