Gratis factuur-API voor ontwikkelaars

Basis-URL

https://freebillgen.com/api/v1

Authenticatie

Elk verzoek maakt gebruik van een Bearer-token. Maak er een aan onder Instellingen → API-sleutels, geef het de benodigde lees-/schrijfrechten per bron, stel eventueel een vervaldatum in en verstuur het bij elk verzoek:

Authorization: Bearer <your-api-key>

Verzoeken worden geauthenticeerd bij het account dat de sleutel heeft aangemaakt en getoetst aan de toegewezen bevoegdheden. Houd het token geheim en trek het in als het openbaar is geworden of niet langer nodig is.

Wat u kunt doen

Lees facturen, klanten, bedrijven, betalingen en terugkerende schema’s
Maak en werk ze bij (schrijf-API - Pro)
Haal btw- en vervaltermijnrapporten op als JSON
Lees dezelfde begrensde wachtrij met volgende acties die door het dashboard wordt gebruikt
Lees e-factuurbestanden van leveranciers die u handmatig hebt geüpload naar de Inbox (geen Peppol-/e-mailontvangstpunt)
Download algemene OASIS UBL- en UN/CEFACT CII-toewijzingen ter beoordeling (niet profielgevalideerd)
Registreer webhook-eindpunten voor factuur- en betalingsgebeurtenissen (Pro)
Idempotency-Key bij ondersteunde schrijfbewerkingen - gewijzigde verzoekgegevens onder dezelfde sleutel leveren een 409-status op
Paginering met de cursor via links.next, instelbaar met per_page (max. 100)
Laat AI-agenten elke gedeelde factuur lezen - schema.org/Invoice JSON-LD, plus Accept: application/json of text/markdown op elke ondertekende deel-link
MCP-server zonder authenticatie en alleen-lezen op https://freebillgen.com/api/mcp (get_invoice, verify_invoice) voor AI-agenten

Conventies

Idempotentie: Verzend bij ondersteunde create- en action-aanroepen een unieke Idempotency-Key. Bij herhaling van identieke verzoekgegevens wordt de oorspronkelijke succesvolle respons opnieuw teruggegeven; gewijzigde verzoekgegevens leveren een 409-status op.
Paginering: Lijsten met opgeslagen bronnen worden met een cursor gepagineerd - volg links.next (of geef ?cursor=... door) en pas ?per_page= aan (max. 100). De begrensde actie-feed rapporteert de limiet en de ingekorte status.
Geld: Geldbedragen zijn exacte JSON-strings die zijn opgemaakt met het aantal decimalen van de valuta volgens ISO 4217, zoals "121.00" voor EUR of "500" voor JPY. Eenheidsprijzen kunnen extra invoernauwkeurigheid behouden.
ID’s: Elke bron wordt aangeduid met een ondoorzichtige id, nooit met een volgnummer.

Voorbeeld: uw facturen ophalen

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

Open de volledige interactieve API-referentie →

Vragen over de factuur-API

Is de factuur-API gratis?

Ja - de lees-API is gratis inbegrepen in het gratis pakket. De schrijf-API en uitgaande webhooks zijn inbegrepen in Lifetime Pro (€ 49 inclusief belasting): één betaling, zonder maandelijkse kosten of jaarlijkse verlenging.

Hoe kan ik me authenticeren?

Maak een Bearer-token aan onder Instellingen -> API-sleutels, wijs er per resource lees-/schrijftoegang toe en verstuur het als een Authorization: Bearer-header bij elk verzoek. Sleutels zijn beperkt tot uw eigen account en kunnen worden ingetrokken of verlopen.

Kan ik facturen programmatisch aanmaken?

Ja, via de schrijf-API, die deel uitmaakt van de Pro-add-on. Deze genereert dezelfde professionele facturen als de webapp, met opeenvolgende nummering en configureerbare btw-verwerking die server-side wordt toegepast. De API garandeert geen naleving van lokale wetgeving.

Hoe voorkom ik dat er bij een nieuwe poging dubbele facturen worden aangemaakt?

Verzend een unieke Idempotency-Key bij de aanmaakaanroep. Het opnieuw verzenden van identieke verzoekgegevens met die sleutel levert het oorspronkelijke resultaat op. Hergebruik ervan met gewijzigde verzoekgegevens levert een 409-fout op in plaats van stilzwijgend een andere factuur terug te geven.

Kan ik de facturen lezen die ik heb ontvangen?

Ja, gratis. GET /api/v1/inbox geeft een overzicht van ondersteunde UBL/CII-leveranciersbestanden die u handmatig hebt geüpload en die door FreeBillGen zijn geparseerd, waarbij het origineel wordt bewaard voor controle; GET /api/v1/inbox/{id} retourneert er één. Syntaxisherkenning is geen profielvalidatie, en deze eindpunten maken van FreeBillGen geen Peppol-, overheidsnetwerk- of e-mailontvangsteindpunt.

Kan een AI-agent een factuur lezen zonder account?

Ja. Elke factuur die u deelt via de ondertekende openbare link is leesbaar voor agents op dezelfde URL: de pagina bevat schema.org/Invoice JSON-LD, en het verzenden van Accept: application/json levert een gestructureerde factuur op (partijen, regelitems, totalen, te betalen saldo, betalingsopties), terwijl Accept: text/markdown een overzichtelijke weergave met weinig tokens oplevert. Er is ook een Model Context Protocol (MCP)-server zonder authenticatie en alleen-lezen beschikbaar op https://freebillgen.com/api/mcp met de tools get_invoice en verify_invoice. De handtekening van de link is het toegangstoken. Behandel de volledige URL als een geheim, want iedereen die deze ontvangt, kan de factuur openen.

Factuur-API