Invoices

An invoice is an invoice or credit note that Watchdog has published. To send invoice files to Watchdog, see Upload invoices.

Find invoices

GET /v1/invoices lists invoices, 50 at a time. Filters are optional:

curl --get "$API_URL/v1/invoices" \
  -H "Authorization: Bearer $API_KEY" -H "X-Organization-Id: $ORGANIZATION_ID" \
  --data-urlencode 'issued_from=2026-09-01' \
  --data-urlencode 'issued_through=2026-09-30'

When next_cursor isn’t null, send it back as cursor to get the next page.

Create and edit

If you already have the invoice as data, create it with POST /v1/invoices instead of uploading a file. Its lines must add up to its totals, otherwise nothing is created. PATCH /v1/invoices/{id} changes only the fields you send. If you send line_items, send the whole list: lines you leave out are removed. Editing doesn’t re-run the invoice’s checks.

Good to know

Amounts are decimal strings such as "1250.00", and rates are fractions: "0.25" means 25%.
amounts.valid only says whether the lines add up to the totals. Whether the invoice follows your agreements is in alerts.
Duplicates. Watchdog keeps one copy of each invoice. Creating the same invoice again returns 409 conflict; uploading it again gives you the existing one back.

Start here

Understand your data

Endpoints

Find invoices

Create and edit

Good to know

​Find invoices

​Create and edit

​Good to know

Find invoices

Create and edit

Good to know