List Accrued Landed Cost
GET/api/ledger/reports/accrued-landed-cost
Accrued Landed Cost report: every receipt line whose receipt added an estimated freight or customs duty amount to stock cost, with what is accrued, cleared, released and still remaining, its age and its auto-release date. Paginated; totals sums every line the filters match.
accounting:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Each line is one receipt line and one component (landed_cost = estimated freight / landed cost, duty = estimated customs duty):
accrued— what the receipt added to stock cost and owes on the accrual account (whole cents)cleared— the estimate a landed-cost bill (or a purchase order cost line) replaced;actualandvariance(actual − estimate) when attributable to billsreleased— the estimate taken back out by a releaseremaining— still owed on the accrualstatus—accrued,cleared,released, orreleased_then_billed(a bill arrived after the release and posted as an ordinary landed-cost true-up)on_hand_quantity— units from this receipt still in stock (a release credits Inventory for this share and Cost of Goods Sold / customs duty variance for the rest)release— when released: id, date,reason(manual|auto), note, who released it, and whether it can still be undone (undo_blocked_reason:billed|locked)auto_release_on/auto_release_in_days— when the remaining accrual is released automatically: N days after the purchase order's last receipt, once it is fully received (or closed short).auto_release_blocked_reason:auto_release_off,po_not_fully_received, orrelease_undone(a release of the line was undone, so auto-release leaves it alone)is_aged— older than the aging threshold with an accrual remaining
Authentication: Requires Bearer token (scope accounting:read).
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.