API

HTTP API

REST onder /api/v1. Bearer-token cijfr_live_…, pakket Studio, optioneel beperkt tot één handelsnaam.

Toegang

Sleutels maak je in de app onder Instellingen. Stuur `Authorization: Bearer cijfr_live_…`. Het pakket Studio is verplicht. Een sleutel kan je beperken tot één Cijfr-profiel (handelsnaam).

Muterende POST-verzoeken accepteren een optionele Idempotency-Key. Dezelfde sleutel plus hetzelfde lichaam speelt het bewaarde antwoord terug; een ander lichaam op dezelfde sleutel is 409.

Bron

De referentie hieronder is gegenereerd uit de OpenAPI-beschrijving 1.1.0. Verzin geen extra paden. Live: GET https://docs.cijfr.com/openapi.json.

Referentie

Gegenereerd uit de OpenAPI-beschrijving. Geen extra paden.

GET /api/v1/me

Current organisation and profile

GET /api/v1/customers

List customers

POST /api/v1/customers

Create a customer

  • name string
  • email? string
  • companyName? string
  • addressLine1? string
  • postalCode? string
  • city? string
  • countryCode? string
  • btwId? string
  • kvkNumber? string
  • externalId? string

GET /api/v1/products

List products

POST /api/v1/products

Create a product

  • name string
  • unitPriceCents integer
  • vatRateBps? integer
  • unit? string
  • sku? string

GET /api/v1/invoices

List invoices

POST /api/v1/invoices

Create an invoice (draft or sent)

  • customerId string
  • issueDate? string
  • dueDate? string
  • send? boolean
  • profileId? string
  • lines array

GET /api/v1/subscriptions

List recurring schedules

POST /api/v1/subscriptions

Create a subscription from invoice-like lines

  • customerId string
  • freq string
  • interval? integer
  • autoSendEmail? boolean
  • autoSendPost? boolean
  • lines array

POST /api/v1/credits

Grant mail credits after a paid top-up (platform billing / Edge Functions)

  • orgId string
  • credits integer
  • reason? string
HTTP API · Cijfr