List Shopify Partner Orders
GET/api/shopify/:integrationInstance/partner-orders
List the Shopify orders a partner ships, one row per record-only drop-ship purchase order at a partner location's supplier warehouse, newest first. Each row carries the sales order, the Shopify order, the partner (supplier, drop-ship warehouse and Shopify location), the items with cost and sold price, the purchase order, its bills, and where its cost stands.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Only partner locations mapped to a supplier warehouse are included (see Apply Shopify Partner Location Mappings).
cost_status (the first that applies):
- cost_missing: a purchase order line has no cost.
- variance: its Collective debit was matched but differs from the purchase order cost plus shipping.
- debit_matched: its Collective debit was matched and billed.
- paid: billed and the bill is paid.
- billed: billed, not paid.
- not_billed: shipped more than 7 days ago and not billed.
- shipped: shipped recently, not billed yet.
- po_recorded: recorded, not shipped yet.
Totals: po_total is the purchase order cost (quantity x unit cost, less discount); sold_total is what the customer paid for the same lines. collective is set for Shopify Collective orders: the supplier's name, its order number and the shipping it charged; otherwise null. shopify_order and partner.location are null when they cannot be resolved.
Pagination: 10 per page by default; standard paginated response.
Authentication: Requires Bearer token (integrations:read).
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 — 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.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.