Public REST API

fakturai E-Rechnung API

Technisch geprüfte EN 16931 ZUGFeRD / Factur-X Rechnungs-PDFs aus Automationen, KI-Agenten und Backends erzeugen.

Endpoint

POST https://fakturai.de/api/v1/invoices
X-API-Key: <FAKTURAI_API_KEY>
Content-Type: application/json
Accept: application/pdf

Erfolgreiche Requests liefern 201 application/pdf. Fehler liefern JSON mit error und detail.

Request Body

Das Seller-Profil hängt am API-Key. Gesendet werden Buyer, Daten, Währung und Rechnungspositionen.

{
  "invoice_date": "2026-06-01",
  "due_date": "2026-06-15",
  "currency": "EUR",
  "buyer": {
    "name": "Acme GmbH",
    "address": {
      "line_one": "Beispielweg 42",
      "postcode": "80331",
      "city": "München",
      "country": "DE"
    },
    "vat_id": "DE123456789",
    "contact_email": "buchhaltung@example.com"
  },
  "lines": [
    {
      "name": "Softwareentwicklung",
      "description": "Umsetzungsarbeit",
      "quantity": "8",
      "unit": "HUR",
      "unit_price": "150.00",
      "vat_rate": "19.00"
    }
  ],
  "number_prefix": "RE-2026"
}

API als Landingpage erklärt

Wenn Sie zuerst den Anwendungsfall statt das Schema prüfen wollen, starten Sie hier.

Schema

Maschinenlesbares Schema: https://fakturai.de/schemas/invoice-input/v1.json

OpenAPI-Spezifikation: https://fakturai.de/openapi.json

OpenAPI-Alias für Crawler: https://fakturai.de/.well-known/openapi.json

Discovery

Root Discovery für Agenten und Integrationen: https://fakturai.de/api/v1. Die JSON-Antwort verlinkt REST-Endpunkt, Schema, OpenAPI, Dokumentation und den gehosteten MCP-Endpunkt.

HEAD https://fakturai.de/api/v1
Link: <https://fakturai.de/openapi.json>; rel="service-desc"
X-Facturai-MCP: https://fakturai.de/mcp
X-Facturai-OpenAPI: https://fakturai.de/openapi.json
X-Facturai-Schema: https://fakturai.de/schemas/invoice-input/v1.json

MCP-Discovery-Methoden wie initialize und tools/list sind lesend erreichbar; rechnungserzeugende Tool-Calls benötigen einen API-Key.

Statuscodes

Status	Bedeutung
`201`	Rechnung wurde erzeugt und als PDF zurückgegeben.
`400`	Ungültiges JSON.
`401`	Fehlender oder ungültiger API-Key.
`402`	Free-Tier-Limit ausgeschöpft.
`422`	Payload ist an Format- oder Validierungsprüfungen gescheitert.
`503`	Generierungsservice nicht verfügbar.

Agent Discovery

Agenten-Zusammenfassung: https://fakturai.de/llms.txt; Crawler-Alias: https://fakturai.de/.well-known/llms.txt. Remote MCP Endpoint: https://fakturai.de/mcp.

Validator

Der kostenlose Validator ist unter https://fakturai.de/de/validator erreichbar.