Get Inbound Shipment Duty Estimates
GET/api/inbound-shipments/:inbound_shipment/duty-estimates
Returns the customs entry for an inbound shipment (the shipment is one customs entry): entry details, entry value, de minimis outcome, entry-level fees (e.g. MPF/HMF with per-entry min/max applied), totals, and per shipment line the estimated duty plus, once received, each receipt's frozen estimate with the actual duty billed against it and the variance.
purchase-orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Rate date: customs entry date, else expected arrival date, else today. Actual duty comes from bills in the Customs Duty cost category allocated to the purchase order line, pro-rated to the received quantity. Line status and totals.status: estimated (nothing received), awaiting_bill, partially_cleared (shipment only), cleared.
Stale estimates are recalculated before responding for shipments of up to 200 lines (otherwise stale: true).
Authentication: Requires Bearer token (scope purchase-orders:read, permission purchase_orders.show).
Each estimate line carries destination_warehouse ({id, name}) — the warehouse the destination country is read from, so a missing_destination line can link to the warehouse whose address needs a country.
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.