v9

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-071292691.1 MB
orders

Get an order by id

Returns the full order detail scoped to the caller account: header (id, external order id, channel, status, currency, creation), resolved customer, shipping/billing addresses, items (with metadata), mirrored payments, totals, the resolved state machine (id/code/name/version + transitions of the pinned version), the fulfillment orders block, and a unified chronological timeline that merges order status events, fulfillment order status events and shipment tracking events (each shipment event carries the resolved carrier and tracking code). An order that does not exist, is soft-deleted, or belongs to another account returns 404.

get/api/v1/orders/{id}

Path parameters

idstring uuid required
Example:01920000-0000-7000-8000-000000000000

Order identifier (UUID).

Response

The order detail.

metadataobject nullable required
idstring required
external_order_idstring required
requested_strategy_codestring nullable required
source_storestring nullable required
shipping_methodstring nullable required
currency'BRL' | 'USD' required
created_atstring required
updated_atstring required