List Shopify Shipping Label Costs
GET/api/shopify/:integrationInstance/label-costs
List the Shopify Shipping label groups SKU.io imported for one Shopify store, newest first. A label group is the labels bought on one order in one hour (UTC) with one carrier and service; Shopify reports no per-label id.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Each group shows the shipment(s) it paid for and whether its cost is on the sales order. A shipment's shipping cost is counted once: a cost from a shipping provider, 3PL, drop-ship supplier or a person on the same shipment wins, and the label is listed as not counted with the reason.
Statuses: counted, counted_partial, not_counted_other_source, held_dropship, excluded_dropship, excluded_by_user, order_not_in_sku, pending_match, voided, disabled.
Pagination: 10 per page by default.
Authentication: Requires Bearer token (integrations:read).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 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.
Unprocessable Entity
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.