Marketplace products
List marketplace product variations
Gets the complete variation map.
GET
Returns { data } with every variation, without pagination, like a kit BOM: the map is replaced whole by the PUT, with at most 100 items. The order is the one of the last PUT; a variation added later (by a binding or by an import) goes last. Each variation links a local Variant to what the marketplace shows; externalVariantId is the id the marketplace assigned, or null before publication.
api_keyheader
AuthorizationBearer <token>API key (mk_...)
marketplaceProductId*stringMatch
^([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)$Format
uuidThe complete variation map, not paginated, in the order of the last PUT.
application/json- response
The complete variation map of a marketplace product.
data*array<>Every variation, in the order of the last PUT; one added later goes last.
curl -X GET "https://example.com/v1/marketplace-products/497f6eca-6276-4993-bfeb-53cbbbba6f08/variants"{ "data": [ { "id": "5b2d7e9a-1c4f-4e6b-8a3d-2f9c0b7e6d41", "marketplaceProductId": "8a6f0c55-6a1e-4c55-9b0a-3b1f2d9e4c10", "variantId": "47c9f819-fcf6-4478-b21a-678ecc594a11", "externalVariantId": null, "desired": { "attributes": [ { "key": "color", "value": { "type": "enum", "value": "black" } }, { "key": "storage", "value": { "type": "text", "text": "128GB" } } ] }, "observed": null, "createdAt": "2026-10-10T12:00:00.000Z", "updatedAt": "2026-10-10T12:00:00.000Z" } ]}