Get Bill
GET/api/shipbob/:instance/bills/:transaction
Get one ShipBob billing transaction with its raw ShipBob payload, the attribution resolution trace (which lookup matched or failed and why), its fee mapping and the financial lines it wrote.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Requires Bearer token.
Each financial line carries sales_order_line (id, sku, product_id, product_name) when the fee was split onto specific order lines of a multi-shipment order.
Financial line amounts are in the currency of the document they sit on (currency_code — the order's or PO's), with amount_in_tenant_currency alongside; tenant_currency_code names the tenant currency.
financial_lines lists what the bill wrote. For a freight charge it includes the fulfillment's single freight line, flagged is_shared_freight: true — that line carries the net of every freight charge on the shipment, not this charge alone.
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
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.