List Orders
GET/api/magento1/orders
Lists Magento 1 orders for one integration instance (the local mirror of orders pulled from the store). Scope with the instance_id query param — without it an empty page is returned so another store's orders never leak. Paginated (default 15/page).
Allowed sorts: id, magento_created_at, magento_updated_at, grand_total, subtotal, status. Prefix with - for descending. Default: -magento_created_at.
Advanced filters (Spatie QueryBuilder): filter[search] (matches id, increment_id, external_order_id, customer email/first/last name); filter[increment_id], filter[external_order_id], filter[status], filter[state], filter[order_currency_code], filter[shipping_method] (text: supports .is / .contains / .starts_with / .ends_with tree operators); filter[grand_total], filter[subtotal], filter[tax_amount], filter[shipping_amount], filter[discount_amount] (numeric comparisons); filter[magento_created_at], filter[magento_updated_at], filter[created_at], filter[updated_at] (datetime ranges); filter[has_sku_order]=true|false (whether a SKU sales order is linked); filter[has_unmapped_items]=true|false (whether any line's Magento product is not linked to a SKU.io product); filter[archived]=only|all (default omitted = Active/non-archived only).
Each line item includes the linked SKU.io product (via the Magento product → product listing mapping) when one exists.
Authentication: Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 429
OK
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.