Get bill payment details

Retrieve the line items and remaining balances of the selected unpaid bills, in the shape used to pay bills (/api/bills/pay) or apply credits (/api/bills/{id}/credit). Select bills with ids in the body, or set include to false to match every bill the query filters allow. Fully paid and repeating bills are skipped.

Required permission: Full Read Accounting

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int32
required

The record type to search: 1 = bills (payables), 2 = invoices (receivables).

int32
≥ 1

Return the single bill with this id.

string

Return bills whose memo contains the given text.

string

Return bills whose reference (or invoice number) contains the given text.

boolean

If true, returns repeating bill templates; if false, only one-time bills.

boolean

If true, returns only fully paid bills; if false, only bills with a remaining amount.

int32
≥ 1

The id of a payee (vendor or customer). Returns bills for that payee.

date-time

Return bills due on or after this date.

date-time

Return bills due on or before this date.

string

Comma-delimited list of status values: 1 = Not Yet Due (due more than 14 days out), 2 = Upcoming (due within the next 14 days, including past-due bills), 3 = Past Due, 4 = Paid, 5 = Written Off.

string

Comma-delimited list of account ids. Returns bills with a line item posted to one of those accounts.

string

Comma-delimited list of fund ids. Returns bills with a line item in one of those funds.

string

Comma-delimited list of accounting tag ids. Returns bills with a line item carrying one of those tags.

Body Params

The selection details

ids
array of doubles | null

The ids the operation applies to: an include list by default, or an exclude list when include is false. For deletes, required unless include is false.

ids
boolean | null

Whether ids is an include list (true, default) or an exclude list (false). Setting include to false with no ids applies the operation to every record matching the query filters.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json