Kostenlose Rechnungs-API für Entwickler

Basis-URL

https://freebillgen.com/api/v1

Authentifizierung

Jede Anfrage verwendet ein Bearer-Token. Erstellen Sie eines unter Einstellungen → API-Schlüssel, weisen Sie ihm die benötigten Lese-/Schreibberechtigungen pro Ressource zu, legen Sie optional ein Ablaufdatum fest und übermitteln Sie es bei jeder Anfrage:

Authorization: Bearer <your-api-key>

Anfragen werden dem Konto zugeordnet, das den Schlüssel erstellt hat, und mit den zugewiesenen Berechtigungen abgeglichen. Halten Sie das Token geheim und widerrufen Sie es, falls es offengelegt wurde oder nicht mehr benötigt wird.

Möglichkeiten der API

Rechnungen, Kunden, Unternehmen, Zahlungen und wiederkehrende Zeitpläne abrufen
Einträge erstellen und aktualisieren (Schreib-API - Pro)
Umsatzsteuer- und Fälligkeitsberichte als JSON abrufen
Dieselbe begrenzte Warteschlange für nächste Aktionen abrufen, die auch das Dashboard nutzt
E-Rechnungsdateien von Lieferanten abrufen, die Sie manuell in den Posteingang hochgeladen haben (kein Peppol-/E-Mail-Empfangsendpunkt)
Generische OASIS-UBL- und UN/CEFACT-CII-Zuordnungen zur Prüfung herunterladen (nicht profilspezifisch validiert)
Webhook-Endpunkte für Rechnungs- und Zahlungsereignisse registrieren (Pro)
Idempotency-Key bei unterstützten Schreibvorgängen - geänderte Anfragedaten unter demselben Schlüssel geben 409 zurück
Cursor-Paginierung über links.next, anpassbar mit per_page (max. 100)
KI-Agenten freigegebene Rechnungen lesen lassen - schema.org/Invoice JSON-LD sowie Accept: application/json oder text/markdown bei jedem signierten Freigabelink
Authentifizierungsfreier, schreibgeschützter MCP-Server unter https://freebillgen.com/api/mcp (get_invoice, verify_invoice) für KI-Agenten

Konventionen

Idempotenz: Senden Sie bei unterstützten Erstellungs- und Aktionsaufrufen einen eindeutigen Idempotency-Key. Bei einer Wiederholung mit identischen Daten wird das ursprüngliche Erfolgsereignis erneut geliefert; geänderte Daten geben den Statuscode 409 zurück.
Paginierung: Gespeicherte Ressourcenlisten verwenden Cursor-Paginierung - folgen Sie links.next (oder übergeben Sie ?cursor=...) und passen Sie ?per_page= an (max. 100). Der begrenzte Aktions-Feed gibt sein Limit und seinen Kürzungsstatus an.
Währungsbeträge: Geldbeträge sind exakte JSON-Strings, formatiert gemäß der ISO-4217-Dezimalstellen der jeweiligen Währung, wie etwa „121.00“ für EUR oder „500“ für JPY. Einzelpreise können zusätzliche Eingabegenauigkeit beibehalten.
IDs: Jede Ressource wird über eine opake ID adressiert, niemals über eine fortlaufende Nummer.

Beispiel: Ihre Rechnungen abrufen

curl https://freebillgen.com/api/v1/invoices \
  -H "Authorization: Bearer $FREEBILLGEN_API_KEY"

Vollständige interaktive API-Referenz öffnen →

Fragen zur Rechnungs-API

Ist die Rechnungs-API kostenlos?

Ja - die Lese-API ist im kostenlosen Tarif ohne Zusatzkosten enthalten. Die Schreib-API und ausgehende Webhooks sind in Lifetime Pro für einmalig 49 € inkl. MwSt. enthalten: eine Zahlung, ganz ohne monatliche Gebühren oder jährliche Verlängerung.

Wie authentifiziere ich mich?

Erstellen Sie ein Bearer-Token unter Einstellungen -> API-Schlüssel, weisen Sie ihm Lese-/Schreibberechtigungen (Scopes) pro Ressource zu und übermitteln Sie es bei jeder Anfrage im Header „Authorization: Bearer“. Schlüssel gelten nur für Ihr eigenes Konto und können widerrufen werden oder ablaufen.

Kann ich Rechnungen programmatisch erstellen?

Ja, über die Schreib-API, die Teil des Pro-Add-ons ist. Sie generiert dieselben professionellen Rechnungen wie die Web-App, inklusive fortlaufender Nummerierung und serverseitig konfigurierbarer Umsatzsteuerbehandlung. Die API bescheinigt keine lokale Rechtskonformität.

Wie verhindere ich Duplikate bei Wiederholungsversuchen?

Senden Sie beim Erstellungsaufruf einen eindeutigen Idempotency-Key mit. Das Wiederholen identischer Anfragedaten mit diesem Schlüssel liefert das ursprüngliche Ergebnis zurück. Die erneute Verwendung mit geänderten Anfragedaten gibt stattdessen den Statuscode 409 zurück, anstatt stillschweigend eine andere Rechnung erneut zu verarbeiten.

Kann ich die empfangenen Rechnungen abrufen?

Ja, kostenlos. GET /api/v1/inbox listet unterstützte UBL-/CII-Lieferantendateien auf, die Sie manuell hochgeladen haben und von FreeBillGen geparst wurden, wobei das Original zu Prüfzwecken aufbewahrt wird; GET /api/v1/inbox/{id} gibt eine einzelne zurück. Die Syntaxerkennung stellt keine Profilvalidierung dar, und diese Endpunkte machen FreeBillGen weder zu einem Peppol-, Behördennetzwerk- noch zu einem E-Mail-Empfangsendpunkt.

Kann ein KI-Agent eine Rechnung ohne Benutzerkonto lesen?

Ja. Jede Rechnung, die Sie über ihren signierten öffentlichen Link teilen, ist unter derselben URL für Agenten lesbar: Die Seite bettet JSON-LD nach schema.org/Invoice ein; das Senden des Headers Accept: application/json liefert eine strukturierte Rechnung zurück (Parteien, Rechnungsposten, Gesamtsummen, fälliger Betrag, Zahlungsoptionen), während Accept: text/markdown eine übersichtliche, Token-sparende Darstellung ausgibt. Zudem steht unter https://freebillgen.com/api/mcp ein authentifizierungsfreier, schreibgeschützter Server für das Model Context Protocol (MCP) mit den Tools get_invoice und verify_invoice zur Verfügung. Die Link-Signatur fungiert als Zugriffstoken. Behandeln Sie die vollständige URL vertraulich, da jede Person, die sie erhält, die Rechnung öffnen kann.