How to do it
- Take the API plan and create a key in your profile, under API keys.
- Send the key in the header: Authorization: Bearer nm_live_... (or X-Api-Key).
- Try /companies/{number}, /companies/{number}/financials, /companies/{number}/peppol and /search?q=.
- Track your usage in the X-RateLimit-Remaining and X-RateLimit-Daily-Remaining headers.
What company data can you request from the API?
- /companies/{number}: the CBE data, in Dutch, French or English (?lang=).
- /companies/{number}/financials: up to ten financial years (?years=1-10, default 5).
- /companies/{number}/peppol: the Peppol registration and document types.
- /search?q=: search by name, number or address, up to 50 results.
The full description is in /openapi.json and on the Developers page.
The API plan
The API is fully described in OpenAPI 3.1.
The API is only available with the API plan: a free account or Pro gives no keys. The API plan costs 999 euros per year excluding VAT: 25,000 calls per month, at most 2,500 per day, up to five keys, Nummo Pro included. Searches do not count toward the monthly quota. At most 60 calls per minute per key.
Privacy
For sole traders the API gives no name, street, contact details or establishments, and you cannot find them by name.
More: How does Altman's Z''-score work? Step by step, with an example. →
Was this helpful?