List orders
Lists the account orders, newest first.
Returns the orders of every seller of the account, paginated, newest first (in the order marketapi stored them). Use it as the work queue of your system.
- Status: filter by
status,paymentStatusandfulfillmentStatus. Each axis moves on its own, so combine them:paymentStatus=paid&fulfillmentStatus=ready_to_shipreturns what is ready to ship. - Purchase period:
placedFromis inclusive andplacedTois exclusive. - What changed:
updatedSincefilters the marketapiupdatedAt, not the marketplace's own time. Keep the instant of your last read and ask again from it. To react right away, use theorder.*webhooks.
Each item is the whole order, as in Get order, with no personal data. The buyer data comes out only through Get buyer.
api_keyAuthorizationBearer <token>API key (mk_...)
page?integerPage number, starting at 1. Defaults to 1. A page beyond pagination.totalPages is not an error: it returns empty data.
1 <= value <= 90071992547409911pageSize?integerItems per page, from 1 to 100. Defaults to 20.
1 <= value <= 10020sellerId?stringOnly orders of this seller.
^([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)$uuidconnectionId?stringOnly orders of this connection.
^([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?stringOnly orders in this state.
"open""completed""cancelled"paymentStatus?stringOnly orders in this payment state.
"pending""authorized""paid""partially_refunded""refunded""cancelled"fulfillmentStatus?stringOnly orders in this fulfillment state.
"pending""ready_to_ship""shipped""delivered""not_delivered""cancelled"placedFrom?stringOnly orders placed at or after this instant (inclusive). ISO-8601; an offset such as -03:00 is accepted.
^(?:(?:\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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-timeplacedTo?stringOnly orders placed before this instant (exclusive). ISO-8601; an offset such as -03:00 is accepted. Must not be before placedFrom.
^(?:(?:\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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-timeupdatedSince?stringOnly orders that changed in marketapi at or after this instant (inclusive). It filters updatedAt, not the marketplace own change time (sourceUpdatedAt). Use it to poll for changes.
^(?:(?:\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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-timeA page of orders, newest first.
application/json- response
One page of orders.
data*array<>Orders in this page, newest first.
pagination*Where this page sits in the whole listing: the totals and whether there are pages before and after it.
curl -X GET "https://example.com/v1/orders"{ "data": [ { "id": "1d2e3f40-5161-4728-9a3b-4c5d6e7f8a9b", "sellerId": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01", "connectionId": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "marketplace": "mercadolivre", "externalId": "2000009876543210", "placedAt": "2026-10-18T14:20:00.000Z", "paidAt": "2026-10-18T14:21:30.000Z", "closedAt": null, "deliveredAt": null, "status": "open", "paymentStatus": "paid", "fulfillmentStatus": "ready_to_ship", "invoiceStatus": "pending", "statusReasons": [], "totals": { "currency": "BRL", "subtotalInCents": 499900, "shippingPaidByBuyerInCents": 2500, "discounts": [ { "amountInCents": 5000, "fundedBy": "seller", "type": "coupon" } ], "taxesInCents": 0, "feesInCents": 60588, "totalInCents": 497400, "netInCents": 436812, "roundingAdjustmentInCents": 0 }, "lines": [ { "id": "2e3f4051-6272-4839-8a4b-5c6d7e8f9a0b", "externalId": "2000009876543210", "externalListingId": "MLB123456789", "externalVariantId": "MLBU1234567", "externalSku": "IPH16-BLK-128", "listingId": "0e2ce906-a6ab-4101-9461-4168c8b6b902", "variantBindingId": "cb064b64-2f63-4c3e-aa42-f11ea0f82b17", "variantId": "47c9f819-fcf6-4478-b21a-678ecc594a11", "linkState": "linked", "quantity": 1, "unitPriceInCents": 499900, "discounts": [ { "amountInCents": 5000, "fundedBy": "seller", "type": "coupon" } ], "fees": [ { "type": "commission", "amountInCents": 59900, "rateBps": 1200, "externalType": "sale_fee" }, { "type": "fixed_fee", "amountInCents": 600, "rateBps": null, "externalType": null } ], "taxes": [] } ], "payments": [ { "id": "3f405162-7383-494a-9b5c-6d7e8f9a0b1c", "externalId": "9988776655", "method": "credit_card", "installments": 3, "amountInCents": 497400, "status": "paid", "paidAt": "2026-10-18T14:21:30.000Z" } ], "hasBuyerContact": true, "sourceUpdatedAt": "2026-10-18T14:21:31.000Z", "createdAt": "2026-10-18T14:21:35.000Z", "updatedAt": "2026-10-18T14:21:35.000Z" } ], "pagination": { "page": 1, "pageSize": 20, "totalItems": 57, "totalPages": 3, "hasNext": true, "hasPrev": false }}