API-Zugang

REST API für die automatisierte Erstellung von Dokumenten — exklusiv im Business-Tarif

Die FakturaCloud REST API ermöglicht es dir, Dokumente programmatisch zu erstellen — z.B. aus deinem ERP-System, Webshop oder einer Automatisierung (n8n, Make, Zapier).

Voraussetzungen

Business-Tarif — Die API ist exklusiv im Business-Plan verfügbar
API Key — Wird im Dashboard unter Einstellungen > API Keys erstellt

Was kann die API?

Funktion	Methode	Endpunkt
Brands auflisten	`GET`	`/api/v1/brands`
Dokumente auflisten	`GET`	`/api/v1/documents`
Dokument erstellen	`POST`	`/api/v1/documents`
API Keys verwalten	`GET / POST / DELETE`	`/api/v1/api-keys`

Basis-URL

https://fakturacloud.de/api/v1

Schnellbeispiel

curl -X POST https://fakturacloud.de/api/v1/documents \
  -H "Authorization: Bearer df_live_dein_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": "deine-brand-uuid",
    "doc_type": "rechnung",
    "customer_name": "Max Mustermann",
    "subject": "Rechnung für Dienstleistungen",
    "items": [
      {
        "name": "Webdesign",
        "quantity": 1,
        "unit_price": 1200.00
      }
    ]
  }'

Antwort:

{
  "data": {
    "id": "uuid-des-dokuments",
    "doc_number": "RE-2026-0001"
  }
}

Limits

Aspekt	Wert
Rate Limit	Ja — bei Überschreitung: `429 Too Many Requests` mit `Retry-After`-Header
Dokumente	Unbegrenzt (Business-Plan)
Brands	Unbegrenzt (Business-Plan)
API Keys	Mehrere pro Konto möglich

Rate Limits

Die API setzt pro API Key (bzw. Konto) ein Rate Limit durch. Die Limits sind für den Business-Tarif großzügig bemessen und reichen für typische Automatisierungen problemlos aus:

Endpunkt	Limit
`GET /api/v1/brands`	300 Anfragen / Minute
`GET /api/v1/documents`	300 Anfragen / Minute
`POST /api/v1/documents`	100 Anfragen / Minute

Wird ein Limit überschritten, antwortet die API mit 429 Too Many Requests und setzt folgende Header:

Header	Bedeutung
`Retry-After`	Sekunden, die du warten solltest, bevor du den Request wiederholst
`X-RateLimit-Remaining`	Verbleibende Anfragen im aktuellen Zeitfenster
`X-RateLimit-Reset`	Zeitpunkt (ISO 8601), zu dem das Fenster zurückgesetzt wird

Empfehlung für Auto-Retry-Integrationen (n8n, Make, Zapier): Verwende exponentielles Backoff und nutze den Retry-After-Wert als Minimum-Wartezeit, bevor du es erneut versuchst. So vermeidest du, dass wiederholte Retries das Limit weiter ausreizen.

Nächste Schritte

Authentifizierung — API Key erstellen und verwenden
Endpunkte — Alle Endpunkte im Detail
OpenAPI-Spezifikation — maschinenlesbare Spec zum Import in Postman oder Insomnia