REST API
Koppel je eigen software aan EenFactuurMaken.nl met de REST API v1. Basis-URL, je eerste verzoek, wat je allemaal kunt en waar je de volledige referentie vindt.
Met de REST API maak je klanten, producten en facturen aan vanuit je eigen software: je webshop, CRM, urenregistratie of een script. Het is dezelfde API die de web-app en de MCP-server gebruiken, dus alles wat in de app kan, kan meestal ook via de API. De API zit in elk plan.
Snel aan de slag
- Maak een API-sleutel bij Instellingen → API & AI. Zie API-sleutels en apps.
- Stuur hem mee in de header
Authorization: Bearer efm_…. - Doe je eerste verzoek:
curl https://eenfactuurmaken.nl/api/v1/me \
-H "Authorization: Bearer $EENFACTUURMAKEN_API_KEY"Je krijgt je account, je plan, de limieten van je plan en je verbruik deze maand terug. Werkt dat, dan kun je alles.
| Basis-URL | https://eenfactuurmaken.nl/api/v1 |
| Formaat | JSON in, JSON uit (PDF, UBL en ZIP als bestand) |
| OpenAPI 3.1-specificatie | https://eenfactuurmaken.nl/api/v1/openapi.json |
| Authenticatie | API-sleutel als Bearer-token of X-API-Key |
Wat kun je ermee?
| Onderdeel | Endpoints |
|---|---|
| Account | GET /me |
| Bedrijfsgegevens en logo | GET/PATCH /business, PUT/GET/DELETE /business/logo |
| Klanten | lijst, maken, ophalen, wijzigen, archiveren; GET /vat-check (VIES) |
| Producten | lijst, maken, ophalen, wijzigen, archiveren |
| Facturen | lijst, maken (concept), wijzigen, verwijderen, kopiëren, definitief maken, creditnota, betaald/onbetaald, annuleren, online link, volgend nummer, wisselkoers |
| Versturen | factuur mailen, herinnering sturen, e-maillog |
| Documenten | PDF, UBL, controle, PDF-voorbeeld |
| Rapporten | statistieken en btw per kwartaal, ZIP-export |
| Layouts, terugkerend, e-maildomeinen | sjablonen (Pro), terugkerende facturen (Pro), eigen afzenderdomein (Pro) |
Alle endpoints met parameters, velden en voorbeelden staan in de endpoint-referentie.
Lees verder
- Authenticatie: sleutels, headers en wat een sleutel niet mag.
- Formaten en paginering: bedragen in centen, datums, lijsten, filters en PATCH.
- Fouten en limieten: de foutvorm, alle foutcodes en rate limits.
- Voorbeelden: complete recepten van concept tot betaald.
- Endpoint-referentie: elk endpoint, gegenereerd uit de OpenAPI-specificatie.
Werk je met een AI-assistent? Dan is de MCP-server vaak handiger: daar heb je geen code voor nodig.
Nederlandse regels in de API
De API past dezelfde regels toe als de app: factuurcontrole bij het definitief maken, doorlopende nummering, de juiste btw-behandeling en de limieten van je plan.
Laatst bijgewerkt op 13 oktober 2026
Kom je er niet uit?
Mail ons op support@eenfactuurmaken.nl. Vertel wat je probeerde en wat er gebeurde, dan helpen we je verder.