Comment faire
- Prenez le plan API et créez une clé dans votre profil, sous Clés API.
- Envoyez la clé dans l'en-tête : Authorization: Bearer nm_live_... (ou X-Api-Key).
- Essayez /companies/{numéro}, /companies/{numéro}/financials, /companies/{numéro}/peppol et /search?q=.
- Suivez votre consommation dans les en-têtes X-RateLimit-Remaining et X-RateLimit-Daily-Remaining.
Quelles données d'entreprise demander via l'API ?
- /companies/{numéro} : les données BCE, en néerlandais, français ou anglais (?lang=).
- /companies/{numéro}/financials : jusqu'à dix exercices (?years=1-10, 5 par défaut).
- /companies/{numéro}/peppol : l'enregistrement Peppol et les types de documents.
- /search?q= : recherche par nom, numéro ou adresse, jusqu'à 50 résultats.
La description complète est dans /openapi.json et sur la page Développeurs.
Le plan API
L'API est entièrement décrite en OpenAPI 3.1.
L'API n'est disponible qu'avec le plan API : un compte gratuit ou Pro ne donne pas de clés. Le plan API coûte 999 euros par an hors TVA : 25 000 appels par mois, au plus 2 500 par jour, jusqu'à cinq clés, Nummo Pro inclus. Les recherches ne comptent pas dans le quota mensuel. Au plus 60 appels par minute et par clé.
Vie privée
Pour les entreprises individuelles, l'API ne donne ni nom, ni rue, ni coordonnées, ni unités, et on ne les trouve pas par le nom.
Plus d'explications: Comment fonctionne le Z''-score d'Altman ? Pas à pas, avec un exemple. →