Get accounts receivable aging

Retrieve AR aging analysis grouped by customer.

Aging buckets:

• Current: Not yet due (0 days overdue)
• 1-30 days: 1-30 days overdue
• 31-60 days: 31-60 days overdue
• 61-90 days: 61-90 days overdue
• 90+ days: 90 or more days overdue

Returns:

• Total outstanding across all customers
• Total aging buckets (sum across all customers)
• Per-customer breakdown (sorted by total outstanding descending)

All values are in cents. Currency is the business’s base currency.

GET /v1/platform/businesses/{business_id}/insights/ar-aging

Get accounts receivable aging

cURL

curl --request GET \
  --url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/insights/ar-aging/ \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "as_of_date": "2023-12-25",
    "currency": "<string>",
    "total_outstanding_cents": 123,
    "total_aging_buckets": {
      "current": 123,
      "days_1_30": 123,
      "days_31_60": 123,
      "days_61_90": 123,
      "over_90_days": 123
    },
    "customers": [
      {
        "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "customer_name": "<string>",
        "total_outstanding_cents": 123,
        "aging_buckets": {
          "current": 123,
          "days_1_30": 123,
          "days_31_60": 123,
          "days_61_90": 123,
          "over_90_days": 123
        }
      }
    ]
  }
]

Authorizations

PartnerJWTBusinessScopedJWTBasicAuthBearerUnscopedBearerBusinessScoped

Authorization · string · header · required

Partner-level JWT token (unscoped). Token payload includes partner_id. Business access is validated via partner ownership. Format: Bearer <your-jwt-token>

Use this for: Multi-business operations where the business_id is specified in the URL and partner has access to multiple businesses.

Path Parameters

business_id · string<uuid> · required

Business UUID

Query Parameters

as_of_date · string<date>

Date to calculate aging as of (YYYY-MM-DD). Defaults to today.

group_by · enum<string> · default: customer

Grouping: 'customer' (default) or 'total'

Available options: customer, total

Response

200

application/json

business_id · string<uuid> · required

Business UUID

as_of_date · string<date> · required

Date to calculate aging as of

group_by · enum<string> · required

Grouping: 'customer' or 'total'

• customer - customer
• total - total

Available options: customer, total

currency · string · required

Business base currency (e.g., EUR, GBP, USD)

total_outstanding_cents · integer · required

Total outstanding across all customers in cents

total_aging_buckets · object · required

Total aging buckets (sum across all customers)

Show child attributes

customers · object[] · required

Per-customer aging breakdown (sorted by total outstanding descending)

Show child attributes