AR aging summary

GET /api/v1/invoices/aging

Returns accounts receivable aging data grouped by customer with Current, 1-30, 31-60, 61-90, and 91+ day buckets. Includes per-invoice detail for drill-down.

Operation ID: get_invoice_aging_api_v1_invoices_aging_get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Responses

200 Successful Response

Schema: InvoiceAgingResponse

as_of_date string required

Report date in YYYY-MM-DD format.

customers array · AgingCustomerSummary requiredAgingCustomerSummary

Per-customer aging summary rows.

8 fields
customer_id string
customer_name string
current integer
days_1_30 integer
days_31_60 integer
days_61_90 integer
days_91_plus integer
total integer
invoices array · AgingInvoiceItem requiredAgingInvoiceItem

Individual invoices with aging bucket for drill-down.

11 fields
id string required
invoice_number string
customer_id string required
customer_name string
status string required
total integer required

Invoice total in cents.

total_paid integer

Total paid in cents.

balance_due integer required

Remaining balance in cents.

due_date string
days_past_due integer
bucket string required

Aging bucket: 'current', '1_30', '31_60', '61_90', '91_plus'.

totals AgingCustomerSummary requiredAgingCustomerSummary

Grand totals across all customers.

8 fields
customer_id string
customer_name string
current integer
days_1_30 integer
days_31_60 integer
days_61_90 integer
days_91_plus integer
total integer

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object