Retrieve a bill (accounts payable)

Returns a single bill, i.e. an accounts payable (AP) record of money the organization owes a vendor, by its ID. The bill is in the same shape as an item of the list endpoint (getBooksBills): its id, referenceNumber (the bill number), vendor (with id and name; omitted when the bill has no recorded vendor), effectiveDate (bill date), dueDate, status, displayStatus, grossAmount (total of all lines), amountRemaining (still owed after applied payments), lines (each with its ledger ID, i.e. general ledger (GL) account, description, and amount), and paymentApplications (each a line entry ID and the amount applied). status is the stored lifecycle status (draft, open, processing, paid, cancelled); displayStatus is what users see, which also distinguishes overdue and partiallyPaid. A vendor's id is a Books counterparty ID, not a recipient ID. Amounts are in dollars. The ID must be a bill: an unknown id, an invoice, or an id from another Books instance returns 404. To discover bill IDs, use the list endpoint (getBooksBills).

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

The ID of the bill to retrieve, as returned by getBooksBills or createBooksBill.

Query Params
uuid

The Books instance to act on. Required for agent organization tokens; defaults to the token organization's instance.

Responses

400

Invalid booksId

404

billId not found

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