Bills
Track vendor bills. Bills post to the ledger, debiting expense accounts and crediting Accounts Payable.
The Bill Object
| Field | Type | Description |
|---|---|---|
| id | string | Bill UUID |
| object | string | Always 'bill' |
| bill_number | string | Bill number |
| status | string | draft, received, open, partially_paid, paid, overdue, or voided |
| date | string | Bill date (ISO 8601) |
| due_date | string | Due date (ISO 8601) |
| currency | string | ISO currency code (e.g., USD) |
| total_cents | number | Bill total in cents |
| amount_due_cents | number | Remaining balance in cents |
| memo | string | Internal memo |
| vendor | object | |
| created_at | string | ISO 8601 timestamp |
Endpoints
GET
/api/v1/billsList bills
Returns a paginated list of bills for the current organization, soonest due first.
Path & Query Parameters
| Parameter | Type | Description |
|---|---|---|
| status | string | Filter by status (draft, received, open, partially_paid, paid, overdue, voided) |
| page | number | Page number (default 1) |
| per_page | number | Results per page (1-200, default 50) |
| limit | number | Legacy: number of results (1-50, default 25), honored only when neither page nor per_page is sent |
PATCH
/api/v1/bills/:id/approveApprove a bill (no effect yet)
Returns the bill unchanged. It does not approve the bill or change its approval status yet; approve bills in the Imprest app.
Path & Query Parameters
| Parameter | Type | Description |
|---|---|---|
| idrequired | string | Bill UUID |