Basis-URL
https://freebillgen.com/api/v1Authentifizierung
Jede Anfrage verwendet ein Bearer-Token. Erstellen Sie eines unter Einstellungen → API-Schlüssel, weisen Sie ihm die benötigten Lese-/Schreibberechtigungen für die jeweiligen Ressourcen zu, legen Sie optional ein Ablaufdatum fest und senden Sie es bei jeder Anfrage mit:
Authorization: Bearer <your-api-key>Anfragen werden für das Konto authentifiziert, das den Schlüssel erstellt hat, und anhand der ihm zugewiesenen Berechtigungen geprüft. Halten Sie das Token geheim und widerrufen Sie es, wenn es offengelegt wurde oder nicht mehr benötigt wird.
Ihre Möglichkeiten
- Rechnungen, Kunden, Unternehmen, Zahlungen und wiederkehrende Zeitpläne lesen
- Diese erstellen und aktualisieren (Schreib-API - Pro)
- Umsatzsteuer- und Fälligkeitsberichte als JSON abrufen
- Dieselbe begrenzte Warteschlange für nächste Aktionen lesen, die auch das Dashboard verwendet
- E-Rechnungsdateien von Lieferanten lesen, die Sie manuell in den Posteingang hochgeladen haben (kein Peppol-/E-Mail-Empfangsendpunkt)
- Allgemeine OASIS UBL- und UN/CEFACT CII-Zuordnungen zur Prüfung herunterladen (nicht profilvalidiert)
- 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, einstellbar mit per_page (max. 100)
- KI-Agenten das Lesen jeder freigegebenen Rechnung ermöglichen - schema.org/Invoice JSON-LD sowie Accept: application/json oder text/markdown für jeden 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 Anfragedaten wird die ursprüngliche erfolgreiche Antwort erneut ausgegeben; geänderte Anfragedaten geben 409 zurück.
- Paginierung
- Listen gespeicherter Ressourcen verwenden Cursor-Paginierung - folgen Sie links.next (oder übergeben Sie ?cursor=...) und passen Sie ?per_page= an (max. 100). Der begrenzte Aktionsfeed gibt sein Limit und seinen Kürzungsstatus an.
- Geldbeträge
- Geldbeträge sind exakte JSON-Zeichenfolgen, die entsprechend den Dezimalstellen der jeweiligen ISO 4217-Währung formatiert sind, beispielsweise "121.00" für EUR oder "500" für JPY. Stückpreise können eine höhere Genauigkeit der Eingabe beibehalten.
- IDs
- Jede Ressource wird über eine nicht auswertbare ID und niemals über eine fortlaufende Nummer adressiert.
Beispiel: Ihre Rechnungen auflisten
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 kostenlos im kostenlosen Tarif enthalten. Die Schreib-API und ausgehende Webhooks sind in Lifetime Pro für 49 € inklusive Steuern enthalten: eine einmalige Zahlung ohne monatliche Gebühr oder jährliche Verlängerung.
Wie authentifiziere ich mich?
Erstellen Sie unter Einstellungen -> API-Schlüssel ein Bearer-Token, weisen Sie ihm Lese-/Schreibberechtigungen für die jeweiligen Ressourcen zu und senden Sie es bei jeder Anfrage als Authorization: Bearer-Header. Schlüssel sind auf Ihr eigenes Konto beschränkt und können widerrufen werden oder ablaufen.
Kann ich Rechnungen programmgesteuert erstellen?
Ja, über die Schreib-API, die Teil des Pro-Add-ons ist. Sie erstellt dieselben professionellen Rechnungen wie die Web-App, wobei die fortlaufende Nummerierung und die konfigurierbare Umsatzsteuerbehandlung serverseitig angewendet werden. Die API bescheinigt keine Konformität mit lokalem Recht.
Wie vermeide ich bei einer Wiederholung die Erstellung doppelter Rechnungen?
Senden Sie beim Erstellungsaufruf einen eindeutigen Idempotency-Key. Wenn Sie identische Anfragedaten mit diesem Schlüssel erneut senden, wird das ursprüngliche Ergebnis zurückgegeben. Wenn Sie ihn mit geänderten Anfragedaten wiederverwenden, wird 409 zurückgegeben, anstatt unbemerkt eine andere Rechnung erneut auszugeben.
Kann ich die Rechnungen lesen, die ich erhalten habe?
Ja, kostenlos. GET /api/v1/inbox listet unterstützte UBL-/CII-Lieferantendateien auf, die Sie manuell hochgeladen und die FreeBillGen analysiert hat; das Original wird für Prüfzwecke aufbewahrt. GET /api/v1/inbox/{id} gibt eine einzelne Datei zurück. Die Syntaxerkennung ist keine Profilvalidierung, und diese Endpunkte machen FreeBillGen nicht zu einem Empfangsendpunkt für Peppol, Behördennetzwerke oder E-Mails.
Kann ein KI-Agent eine Rechnung ohne Konto lesen?
Ja. Jede Rechnung, die Sie über ihren signierten öffentlichen Link freigeben, kann von Agenten unter derselben URL gelesen werden: Die Seite bettet schema.org/Invoice JSON-LD ein. Das Senden von Accept: application/json gibt eine strukturierte Rechnung zurück (Parteien, Positionen, Summen, ausstehender Betrag, Zahlungsoptionen), während Accept: text/markdown eine übersichtliche Darstellung mit geringem Token-Verbrauch zurückgibt. Außerdem steht unter https://freebillgen.com/api/mcp ein authentifizierungsfreier, schreibgeschützter Model Context Protocol (MCP)-Server mit den Tools get_invoice und verify_invoice zur Verfügung. Die Signatur des Links ist das Zugriffstoken. Behandeln Sie die vollständige URL vertraulich, da jeder, der sie erhält, die Rechnung öffnen kann.