Get product
Gets a reusable base record by id.
Use this endpoint when you already know the productId, for example after selecting an item from a list or receiving a product webhook. The response is only the base record; it does not embed Variants, balance, listings, or external marketplace state.
Make separate, explicit calls for Variants, kit components, and related Listings. That keeps a simple catalog read from loading every commercial and inventory concern.
api_keyAuthorizationBearer <token>API key (mk_...)
productId*string^([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)$uuidThe requested product.
application/json- response
A reusable product base, independent of marketplace listings.
id*stringProduct identifier.
^([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)$uuidsellerId*stringSeller that owns this product.
^([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)$uuidstatus*stringLifecycle state of the product.
"active""archived"content*Reusable product content.
identity*Reusable identity fields.
attributes*array<>Typed product attributes.
items <= 200physical*|Product-level physical data, if any.
fiscal*Brazilian fiscal product data.
compliance*Safety and regulatory compliance declarations.
metadata*Customer-owned product metadata.
media*array<>Ordered product media.
createdAt*stringWhen the product was created.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdatedAt*stringWhen the product was last changed.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X GET "https://example.com/v1/products/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "a0f0ce59-5d17-49bf-8b45-d1dc057daab4", "sellerId": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01", "status": "active", "content": { "title": { "pt-BR": "iPhone 16" } }, "identity": { "brand": "Apple", "model": "iPhone 16" }, "attributes": [], "physical": null, "fiscal": {}, "compliance": { "certifications": [], "warnings": [] }, "metadata": {}, "media": [], "createdAt": "2026-10-10T12:00:00.000Z", "updatedAt": "2026-10-10T12:00:00.000Z"}