List bills

Returns purchase bills available to the credential-bound company. filter[status] accepts draft, open, paid, part-paid or voided; unsupported values return 422 with the allowed values. Filter by exact number, inclusive date_from/date_to (document date), and gross amount, amount_min/amount_max in the bill currency. For compact output use fields[bills]=id,document_number,vendor_id,date_of_document,amount_gross_total,status; unselected nested data is omitted. Results use cursor pagination and support the documented filters, sorting, includes, and sparse fields. Each bill carries flow: expense for a bill recorded as paid from a company account (named in paid_from; settle it by matching its bank line through reconciliation matches), payable for any other. filter[flow]=expense or payable narrows the list. filter[search] searches as the bills list in Cybooks does: the supplier invoice number, the supplier name, the vendor, the amount, the date and the line text. Requires the bills:read OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum
Allowed:
string
length ≤ 255

Exact supplier document number.

date

Inclusive document date, YYYY-MM-DD.

date
number
-999999999999 to 999999999999

Gross amount in the bill currency; inclusive bounds combine with exact amount.

number
-999999999999 to 999999999999
number
-999999999999 to 999999999999
integer
1 to 100
Defaults to 25

Number of resources per cursor page (1-100).

string

Opaque cursor returned by the preceding collection response.

string

Comma-separated allowlisted sort fields; prefix descending fields with a minus sign.

string

Comma-separated allowlisted relationships.

string

Comma-separated allowlisted sparse response fields. The id field is always retained.

string

Allowlisted exact or bounded collection filter.

string

Allowlisted exact or bounded collection filter.

string

Allowlisted exact or bounded collection filter.

string

Allowlisted exact or bounded collection filter.

string

Allowlisted exact or bounded collection filter.

string

Allowlisted exact or bounded collection filter.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*