Skip to main content

List payables

GET 
/payables

Returns a cursor-paginated page of payables (accounts payable) for the workspace tied to the token's sub claim. Each row includes denormalised display names (person_name, category_name, classification_center_name) and aggregate counts (tax_charges_count, classification_center_allocations_count, attachments_count) — full child collections live in the per-resource detail endpoints. Each row also carries the settlement amounts (interest_amount, discount_amount, ticket_amount) and a derived nominal_amount = amount + interest - discount. Status is the raw DB enum (pending / paid / cancelled); derive overdue client-side via status === "pending" AND due_date < today. Default sort is due_date ascending. Payables awaiting human authorization (see the create endpoint) are omitted from this list until an operator authorizes them in the app; a title is still retrievable by id via GET /payables/{id}. To list the authorization queue instead, filter it explicitly — ?payment_authorization=pending_authorization (read-only; there is no authorize/reject action on this API). Each row carries its payment_authorization state. Requires scope finance.payables.

Request​

Responses​

Page of payables plus pagination metadata.