The Bill

A bill is an OnboardMe invoice. List by bill date range, download the PDF, and read Xero ledger fields when connected.

A bill is an invoice. List with GET /api/v1/bills/list filtered by bill date (startDate / endDate). Detail includes ledger fields when Xero is connected.

POST /api/v1/bills creates an adhoc bill for an Active client only. It does not itself push to Xero. Proposal-linked invoices belong on proposal create, not this route.

See Bills.

Attributes

billingId · integer

Identifier for this invoice.

entityKey · uuid

The client being billed.

billDate · date

Invoice date. List filters use this range, not created-at.

externalId · string

Ledger id when Xero is connected.

externalNumber · string

Ledger invoice number when Xero is connected.

externalUrl · string

Link to the invoice in the ledger, when available.

Recurring billing is a separate schedule object (GET /api/v1/recurring-billing/list). Ledger numbers appear on generated bills, not on the schedule row.

The Bill object

{
  "billingId": 1842,
  "entityKey": "2c4f6a88-1b3d-5e7f-90ab-cdef12345678",
  "billDate": "2026-04-01",
  "externalId": "INV-1042",
  "externalNumber": "INV-1042",
  "externalUrl": "https://go.xero.com/AccountsReceivable/View.aspx?InvoiceID=..."
}