List bills

curl --request GET \
  --url https://anzapi.onboardme.app/api/v1/bills/list \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://anzapi.onboardme.app/api/v1/bills/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://anzapi.onboardme.app/api/v1/bills/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://anzapi.onboardme.app/api/v1/bills/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://anzapi.onboardme.app/api/v1/bills/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

[
  {
    "billingID": 12001,
    "engagementID": 4501,
    "engagementName": "FY26 — Corporate tax",
    "clientName": "Acme Pty Ltd",
    "billDate": "2026-07-01",
    "billNumber": "0000001234",
    "billTotal": 1100,
    "paymentTotal": 0,
    "invoiceStatus": "Unpaid",
    "externalID": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "externalNumber": "INV-1001",
    "externalURL": "https://go.xero.com/AccountsReceivable/View.aspx?InvoiceID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  }
]

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Bills

List bills

Returns bills (invoices) for your practice within a bill date range.

Unlike most list endpoints, this uses startDate / endDate (not lastUpdated).

Optional filters: searchFilter, invoiceStatus (Paid, Unpaid, Partially Paid, Overpaid, Cancelled), billNowFilter (0 neither, 1 upfront, 2 on completion), pageNumber (1-based).

Each row includes ledger sync fields when present: externalId, externalNumber, externalUrl.

400: Missing/invalid dates or pageNumber.

429: Rate limit exceeded.

GET

api

bills

list

List bills

curl --request GET \
  --url https://anzapi.onboardme.app/api/v1/bills/list \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://anzapi.onboardme.app/api/v1/bills/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://anzapi.onboardme.app/api/v1/bills/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://anzapi.onboardme.app/api/v1/bills/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://anzapi.onboardme.app/api/v1/bills/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

[
  {
    "billingID": 12001,
    "engagementID": 4501,
    "engagementName": "FY26 — Corporate tax",
    "clientName": "Acme Pty Ltd",
    "billDate": "2026-07-01",
    "billNumber": "0000001234",
    "billTotal": 1100,
    "paymentTotal": 0,
    "invoiceStatus": "Unpaid",
    "externalID": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "externalNumber": "INV-1001",
    "externalURL": "https://go.xero.com/AccountsReceivable/View.aspx?InvoiceID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  }
]

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Authorizations

Authorization

string

header

required

Swagger / Postman only: Client ID as username, Client secret as password. In Postman, set this once on the collection (Authorization → Basic Auth) so all requests inherit. For production server-to-server code, prefer X-OM-Auth-ID and X-OM-Auth-Key headers.

Query Parameters

startDate

string<date-time>

Inclusive start of bill-date range (required).

endDate

string<date-time>

Inclusive end of bill-date range (required).

searchFilter

string

Free-text search across common bill fields.

pageNumber

integer<int32>

1-based page index (1–10000). Default 1.

invoiceStatus

string

Paid | Unpaid | Partially Paid | Overpaid | Cancelled.

billNowFilter

integer<int32>

0 = neither, 1 = upfront, 2 = on completion.

Response

billingID

integer<int32>

engagementID

integer<int32>

engagementName

string | null

engagementStatusID

integer<int32> | null

isEngagementFinalised

boolean

clientName

string | null

billDate

string<date>

billNumber

string | null

billTotal

number<double>

billDetails

string | null

paymentTotal

number<double>

currencyID

integer<int32>

entityID

integer<int32> | null

invoiceStatus

string | null

externalID

string | null

externalNumber

string | null

externalURL

string | null

syncAttemptCount

integer<int32>

syncFailedReason

string | null

API documentation

Endpoints

Building blocks

List bills

Authorizations

Query Parameters

Response