List Uncategorised Duty Bill Lines
GET/api/v2/cost-categories/duty-line-candidates
List bill lines whose description reads as customs duty but that have no cost category — lines imported from an accounting system, typed by hand, or created before automatic categorisation. These are invisible to actual duty, the duty reconciliation report and duty accrual until they are in your customs duty category.
settings:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the accounting.manage_settings permission (PAT scope settings:read).
A line matches when its description contains a whole keyword — "duty", "duties", "customs duty", "tariff", "tariffs", "MPF", "HMF", or a keyword alias of your customs duty category — and none of its negative keywords ("duty free" by default). Newest bills first.
Fields
amount— the line total (amount × quantity) in the bill's currency (currency_code).locked— the bill is dated on or before the accounting lock date, so the line's category can't change.
Paginated: page, per_page (default 10, max 100).
Request
Responses
- 200
- 401
- 403
- 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.
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.