Zo doe je het
- Neem het API-plan en maak in je profiel, onder API-sleutels, een sleutel.
- Stuur de sleutel mee in de header: Authorization: Bearer nm_live_... (of X-Api-Key).
- Probeer /companies/{nummer}, /companies/{nummer}/financials, /companies/{nummer}/peppol en /search?q=.
- Volg je verbruik in de headers X-RateLimit-Remaining en X-RateLimit-Daily-Remaining.
Welke bedrijfsgegevens kan je via de API opvragen?
- /companies/{nummer}: de KBO-gegevens, in het Nederlands, Frans of Engels (?lang=).
- /companies/{nummer}/financials: tot tien boekjaren (?years=1-10, standaard 5).
- /companies/{nummer}/peppol: de Peppol-registratie en documenttypes.
- /search?q=: zoeken op naam, nummer of adres, tot 50 resultaten.
De volledige beschrijving staat in /openapi.json en op de pagina Ontwikkelaars.
Het API-plan
De API is volledig beschreven in OpenAPI 3.1.
De API zit enkel in het API-plan: een gratis account of Pro geeft geen sleutels. Het API-plan kost 999 euro per jaar exclusief btw: 25.000 oproepen per maand, hoogstens 2.500 per dag, tot vijf sleutels, en Nummo Pro inbegrepen. Zoekopdrachten tellen niet mee voor het maandquotum. Per sleutel hoogstens 60 oproepen per minuut.
Privacy
Bij eenmanszaken geeft de API geen naam, straat, contactgegevens of vestigingen, en je vindt ze niet op naam.
Meer uitleg: Hoe werkt de Z''-score van Altman? Stap voor stap, met een voorbeeld. →
Was dit nuttig?