API documentation | API docs for agents | OpenAPI 3.1

GET /api/v1/reports/aging/details

ark.list_aging_details

Lists unpaid invoice or settlement detail rows for one customer or carrier aging summary row with search, currency, pagination, and sort controls.

Availability

Expanded preview

Scopes

reports:read

ARK permissions

canViewReportscanViewAgingReport

Team visibility

Required and enforced

Idempotency-Key

Not required

Approval

No MCP approval on REST API-token calls

Rate limit

API credential and organization budgets

Parameters

directionquerystringrequired

one of: receivables, payables

entity_idquerystringrequired

Customer ID for receivables or carrier ID for payables.

format: uuid

team_idsquerystring

Comma-separated visible team IDs. Omit to use every team available to the credential.

searchquerystring

max length: 200

currency_codequerystring

one of: USD, CAD, MXN

pagequeryinteger

default: 1; min: 1

page_sizequeryinteger

default: 25; min: 1; max: 500

sort_columnquerystring

one of: docNumber, amountDue, ageDays, bucket, status, pickupNumber, loadNumber, settlementNumber; default: "ageDays"

sort_directionquerystring

one of: asc, desc; default: "desc"

Request body

None.

Example request

curl 'https://arktms.com/api/v1/reports/aging/details?direction=<direction>&entity_id=<entity_id>' \
  -H "Authorization: Bearer $ARK_API_TOKEN"

Success response

Aging detail rows

Errors

HTTP 400

Invalid request

HTTP 401

Authentication required

HTTP 403

Permission, scope, team, or entitlement denied