# Cijfr API

> REST API for invoices, customers, products, subscriptions and mail credits. Authenticate with `Authorization: Bearer cijfr_live_…`. Studio plan required. Keys carry scopes and are limited to 60 requests per minute. Outgoing webhooks retry with `X-Cijfr-Signature: sha256=`.

Invoices, customers, products, subscriptions and hosted checkouts for Dutch freelancers and small businesses. Amounts are integer cents. Sent invoices are immutable.

## Docs (English)

- [Getting started with the API](https://docs.cijfr.com/documentatie/start.md?lang=en): What the Cijfr API is, what you need, and your first request in three steps.
- [Authentication and keys](https://docs.cijfr.com/documentatie/authentication.md?lang=en): Bearer keys, per-resource scopes, profile restriction and how to keep keys safe.
- [Conventions](https://docs.cijfr.com/documentatie/conventions.md?lang=en): JSON conventions, cents, dates, errors, rate limits and idempotency. Read this once and the rest is predictable.
- [Customers](https://docs.cijfr.com/documentatie/customers.md?lang=en): `GET` and `POST /api/v1/customers`. Customers are the recipients of invoices and checkouts.
- [Products](https://docs.cijfr.com/documentatie/products.md?lang=en): `GET` and `POST /api/v1/products`. Products are reusable invoice lines with a price and a VAT rate.
- [Invoices](https://docs.cijfr.com/documentatie/invoices.md?lang=en): `GET` and `POST /api/v1/invoices`. Create a draft or send immediately: sending numbers and locks.
- [Subscriptions](https://docs.cijfr.com/documentatie/subscriptions.md?lang=en): `GET` and `POST /api/v1/subscriptions`. Recurring schedules that create invoices by themselves.
- [Hosted checkout](https://docs.cijfr.com/documentatie/checkouts.md?lang=en): `GET` and `POST /api/v1/checkouts`. A payment link on your house style; after payment the invoice exists automatically.
- [Webhooks](https://docs.cijfr.com/documentatie/webhooks.md?lang=en): Cijfr POSTs events to your HTTPS endpoint, signed with your own secret. Up to five attempts with growing pauses.
- [Reference](https://docs.cijfr.com/documentatie/reference.md?lang=en): Every endpoint in one table, generated from the OpenAPI description. The same description is served live.
- [For AI agents](https://docs.cijfr.com/documentatie/llms.md?lang=en): This documentation is also plain Markdown. Give an agent one URL or one file and it knows the whole API.

## Docs (Nederlands)

- [Beginnen met de API](https://docs.cijfr.com/documentatie/start.md): Wat de Cijfr API is, wat je nodig hebt en je eerste verzoek in drie stappen.
- [Authenticatie en sleutels](https://docs.cijfr.com/documentatie/authentication.md): Bearer-sleutels, scopes per resource, profielbeperking en hoe je sleutels veilig beheert.
- [Conventies](https://docs.cijfr.com/documentatie/conventions.md): JSON-conventies, centen, datums, fouten, rate limits en idempotency. Lees dit één keer en de rest is voorspelbaar.
- [Klanten](https://docs.cijfr.com/documentatie/customers.md): `GET` en `POST /api/v1/customers`. Klanten zijn de ontvangers van facturen en checkouts.
- [Producten](https://docs.cijfr.com/documentatie/products.md): `GET` en `POST /api/v1/products`. Producten zijn herbruikbare factuurregels met een prijs en btw-tarief.
- [Facturen](https://docs.cijfr.com/documentatie/invoices.md): `GET` en `POST /api/v1/invoices`. Maak een concept of verstuur direct: versturen nummert en vergrendelt.
- [Abonnementen](https://docs.cijfr.com/documentatie/subscriptions.md): `GET` en `POST /api/v1/subscriptions`. Terugkerende schema's die zelf facturen maken.
- [Hosted checkout](https://docs.cijfr.com/documentatie/checkouts.md): `GET` en `POST /api/v1/checkouts`. Een betaallink op jouw huisstijl; na betaling staat de factuur er automatisch.
- [Webhooks](https://docs.cijfr.com/documentatie/webhooks.md): Cijfr POST gebeurtenissen naar jouw HTTPS-endpoint, ondertekend met een eigen secret. Tot vijf pogingen met oplopende pauze.
- [Referentie](https://docs.cijfr.com/documentatie/reference.md): Alle endpoints in één tabel, gegenereerd uit de OpenAPI-beschrijving. Dezelfde beschrijving draait live.
- [Voor AI-agenten](https://docs.cijfr.com/documentatie/llms.md): Deze documentatie is ook platte Markdown. Geef een agent één URL of één bestand en hij kent de hele API.

## Machine-readable

- [Complete docs, English](https://docs.cijfr.com/llms-full.txt?lang=en)
- [Complete docs, Nederlands](https://docs.cijfr.com/llms-full.txt)
- [OpenAPI 3.1 spec](https://docs.cijfr.com/openapi.json)