List Duty Reconciliation Rows
GET/api/v2/reports/duty-reconciliation
Duty Reconciliation report: estimated customs duty booked at receipt against the actual Customs Duty bills allocated to the same purchase order lines, grouped by inbound shipment (default), product, supplier or month.
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The estimate is the duty frozen when the goods were received. The actual is each purchase order line's Customs Duty bill allocations, pro-rated to the received quantity. Variance = actual - estimate on the cleared receipts; variance_percent is that variance over the estimate booked on those receipts.
Row status: awaiting_bill (estimate booked, no duty bill yet), partially_cleared (some receipts billed), cleared (every estimated receipt billed), no_estimate (no estimable duty and no bill), actual_without_estimate (a duty bill allocated where no estimate was booked). uncleared is the estimate still awaiting a bill. is_aging / is_big_variance flag rows past the aging and variance thresholds.
Amounts are in the tenant's base currency. Requires the reports scope (read) and access to the Duty Reconciliation report.
Request
Responses
- 200
- 401
- 403
- 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.
Unprocessable Content
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.