Skip to main content
The Watchdog API provides server-to-server invoice ingestion and reconciliation. The generated endpoint reference on this site comes directly from Watchdog’s production OpenAPI 3.1 contract.

​
Base URL

All versioned operations are under /v1. Requests and responses use JSON except for invoice upload, which uses multipart/form-data.

​
Available operations

​
Typical integration flow

1

Create an API key

An organization administrator creates a key in Watchdog and stores the plaintext token securely.
2

Upload an invoice

Send the primary invoice document and optional attachments. A successful response returns 201 Created and a Location header.
3

Poll the invoice resource

Fetch the Location resource while invoice or alert processing is active. Respect Retry-After whenever it is present.
4

Use the result

Read processing state, aggregate alert state, and invoice_url. Treat a result as conclusive for the current snapshot only when the relevant processing status is terminal.

Authentication

Create, store, rotate, and send API keys safely.

Upload and poll

Implement the complete invoice-ingestion lifecycle.