AP aging summary

GET /api/v1/bills/aging

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

Operation ID: get_bill_aging_api_v1_bills_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: BillAgingResponse

as_of_date string required

Report date in YYYY-MM-DD format.

vendors array · AgingVendorSummary requiredAgingVendorSummary

Per-vendor aging summary rows.

8 fields
vendor_id string
vendor_name string
current integer
days_1_30 integer
days_31_60 integer
days_61_90 integer
days_91_plus integer
total integer
bills array · AgingBillItem requiredAgingBillItem

Individual bills with aging bucket for drill-down.

11 fields
id string required
bill_number string
vendor_id string required
vendor_name string
status string required
amount integer required

Bill amount 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 AgingVendorSummary requiredAgingVendorSummary

Grand totals across all vendors.

8 fields
vendor_id string
vendor_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