Get Sales Order Tax Summary
GET/api/sales-orders/:salesOrder/tax
Gets the tax picture of a sales order: the order's tax total and whether prices include tax, who is responsible for collecting the tax (seller or marketplace facilitator) and where that answer came from, the account the order's tax posts to, whether SKU.io computes the order's tax itself, the customer's tax exemption, the tax on every line and revenue charge, and the tax refunded on the order's credits.
orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
responsibility.source is one of evidence (read from the order's own channel data, e.g. a marketplace facilitator tax breakdown), override (set manually on the channel), default (the channel's default) or unclassified (defaults to seller); responsibility.source_label says the same in words. posted_tax_account is the account the order's tax posts to, as "code name": the Marketplace Facilitator Tax clearing account when the order's tax clears through it, otherwise the Sales Tax account; null when that account is not mapped.
Amounts are decimals in the order's currency. net is the line's revenue after line and order discounts (amount × quantity − discounts); amount on a charge is its extended amount.
Authentication: Requires a Bearer token with the orders:read scope. Requires the sales_orders.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 — 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.