List Orders
GET/api/shippo/instances/:integration_instance/orders
Paginated Shippo orders for the instance. An order is created at Shippo for each fulfillment order pushed to it (or imported by the order sync). Each row includes the recipient address, totals, status (raw order_status plus a readable order_status_label), the label count (transactions_count), tracking_numbers (tracking numbers of the order's live labels — bought and not refunded), a "View in Shippo" link (external_url) and cross-link fields to the originating fulfillment order and sales order.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filtering: every filter[<column>] param below accepts an operator suffix, filter[<column>.<operator>]=<value>; list operators take a comma-separated value. Alternatively pass a nested AND/OR tree in filter_groups (base64-encoded JSON) — see that param. filter[linked_to_sku] (or its older alias filter[has_fulfillment_order]) narrows to orders linked / not linked to a SKU.io fulfillment order.
Sorting: id, shippo_object_id, order_number, order_status, receiver_name, receiver_city, receiver_state, total_price, placed_at, details_last_updated, created_at, updated_at, transactions_count (default -id). Pagination: per_page defaults to 10.
Returns a standard paginated envelope: data[] plus current_page, from, to, per_page, total, last_page, first_page_url, last_page_url, next_page_url, prev_page_url, path and links. Returns 404 for an unknown instance.
Authentication: Requires a Bearer token.
Requires the integrations.show permission.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not Found
Response Headers
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.