> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices

> Find, create and edit invoices.

An invoice is an invoice or credit note that Watchdog has published. To send invoice files to
Watchdog, see [Upload invoices](/api-reference/upload-invoices).

## Find invoices

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

```bash theme={null}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.