OpenAPI 3.0.3

API & MCP

Verbinden Sie Claribill mit Ihrer Buchhaltung, Ihrem Shop oder eigenen Anwendungen. Die REST-API deckt die Funktionen des Dashboards ab – mit interaktivem Explorer, Code-Beispielen und einer OpenAPI-Spezifikation zum Download.

OpenAPI-Spezifikation

REST-API v1

134 Endpunkte in 15 Bereichen – Rechnungen, Kunden, Belege, Exporte und mehr.

Sichere Schlüssel

API-Schlüssel mit Präfix sk_live_, je Firma und mit 22 fein abgestuften Scopes.

OpenAPI 3.0

Vollständige Spezifikation zum Download – für Postman, Insomnia, Code-Generatoren und eigene SDKs.

Limits

100 Anfragen pro Minute je Schlüssel. Monatskontingent: Professional: 50.000 · Enterprise: 250.000.

Schnellstart

Basis-URL https://www.claribill.com/api/v1. Alle Antworten sind JSON in der Form { data: … }, Listen zusätzlich mit pagination.

# Versendete Rechnungen abrufen
curl "https://www.claribill.com/api/v1/invoices?status=SENT&limit=10" \
  -H "Authorization: Bearer $CLARIBILL_API_KEY"

# Rechnungsentwurf anlegen
curl -X POST "https://www.claribill.com/api/v1/invoices" \
  -H "Authorization: Bearer $CLARIBILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "KUNDEN_ID",
    "lines": [
      { "description": "Beratung", "quantity": 10, "unitPrice": 150, "taxRate": 20 }
    ]
  }'

Authentifizierung

Senden Sie Ihren API-Schlüssel bei jeder Anfrage im Authorization-Header. Der Schlüssel gehört zu genau einer Firma; alle Abfragen sind auf diese Firma beschränkt. Welche Endpunkte ein Schlüssel nutzen darf, legen seine Scopes fest.

Authorization: Bearer sk_live_…

Im API-Explorer tragen Sie den Schlüssel über Authorize ein und können jede Anfrage mit Try it out direkt gegen Ihre Firma ausführen. Der Schlüssel wird nicht gespeichert.

Webhooks

Statt regelmäßig abzufragen, kann Claribill Ereignisse wie versendete oder bezahlte Rechnungen per HMAC-signiertem Webhook an Ihr System melden (Enterprise). Die Endpunkte dafür finden Sie im Explorer unter webhooks, die Ereignisliste in der Dokumentation.

API & MCP | Claribill