Skip to main content

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.

Required scope: settings:read

Grant 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​

OK

Response Headers
    Content-Type