Données de référence KBO/BCE BNB Peppol Adresses Belgique VIES Code lists LEI TVA Codes bancaires France Téléphone Plan comptable Taxonomies
BÊTA

AXITAM Public API

Des données prêtes à l'emploi pour vos applications, gratuites, en JSON :

  • pays, subdivisions, devises, langues, écritures et régions, avec leurs liens, traduits dans des dizaines de langues ;
  • les taux de change de référence de l’euro de la Banque centrale européenne, depuis 1999 ;
  • toutes les entreprises belges, pour remplir et vérifier vos formulaires ;
  • les comptes annuels que les entreprises belges déposent à la Banque nationale ;
  • toutes les adresses belges, pour compléter et valider vos formulaires ;
  • tout lieu ou adresse dans le monde, cherché au fil de la frappe ;
  • les numéros de TVA européens vérifiés en direct dans VIES, avec le numéro de consultation qui prouve la vérification ;
  • les listes de codes de la facture électronique européenne (EN 16931) et du réseau Peppol ;
  • les taux de TVA des 27 États membres de l’UE, depuis 2016, avec ce à quoi s’applique chaque taux réduit ;
  • les codes d’identification bancaire belges de la Banque nationale : la banque et le BIC derrière chaque IBAN belge ;
  • le plan comptable minimum normalisé belge (PCMN / MAR) de la CNC, en quatre langues, avec ses notes ;
  • les taxonomies XBRL des comptes annuels belges depuis 2015 : modèles, rubriques, faits et contrôles de la Banque nationale ;
  • les unités légales et établissements français du répertoire Sirene de l’Insee (SIREN, SIRET) ;
  • les numéros de téléphone de tous les pays vérifiés et formatés (E.164), avec leur type, leur région et leur fuseau horaire ;
  • les identifiants LEI des entreprises du monde entier, avec leur forme juridique et leur structure de groupe ;
  • qui reçoit des factures électroniques sur le réseau Peppol, dans le monde entier.

ISO 3166-1 · ISO 3166-2 · ISO 3166-3 · ISO 4217 · ISO 639-3 · ISO 639-5 · ISO 15924 · UN M49BCE/KBO Open Data · NACE-BELCentrale des bilans de la BNBTaux de référence BCEBeSt AddressOpenStreetMap · PhotonAnnuaire PeppolVIESGLEIF · LEITEDBCodes bancaires BNB · IBAN · BICPCMN / MARTaxonomies XBRL BNBINSEE Sirene · NAFE.164 · libphonenumberEN 16931 · Peppol code listsmises à jour chaque jour

Explorer dans Swagger UI Essayer maintenant

Explorer les API

Du JSON simple en HTTPS, en lecture seule, sans SDK. Choisissez une région, modifiez les valeurs d'exemple et envoyez : vous voyez la requête, puis la réponse en direct. Chaque API a sa propre spécification OpenAPI.

🌐 Données de référence générales

Les normes internationales : pays, devises, langues, écritures et régions, leurs liens, traduits dans des dizaines de langues avec lang, et les taux de change de l’euro de la BCE. Les listes de codes de la facture électronique (EN 16931, Peppol), telles que leurs éditeurs les publient. Les taux de TVA des États membres viennent de la base « Taxes in Europe » de la Commission.

Pays

ISO 3166-1 / 3166-2 / 3166-3

Les pays par code alpha-2, alpha-3 ou numérique, leurs subdivisions (régions, provinces...), les devises et langues qu'on y utilise, et les anciens pays.

GET /api/v1/countries/{code} GET /api/v1/countries/{code}/subdivisions GET /api/v1/countries/{code}/currencies GET /api/v1/countries/{code}/languages GET /api/v1/former-countries
Spécification OpenAPI →

Devises

ISO 4217

Les devises en cours avec leurs décimales et l'arrondi des espèces, par code alphabétique (EUR) ou numérique (978), et les pays qui utilisent chacune.

GET /api/v1/currencies GET /api/v1/currencies/{code} GET /api/v1/currencies/{code}/countries
Spécification OpenAPI →

Taux de change

Banque centrale européenne · taux de référence de l’euro

Les taux de change de référence de l’euro publiés par la BCE, repris chaque jour ouvré après leur publication (vers 16 h CET) : taux quotidiens depuis 1999 et moyennes mensuelles, trimestrielles et annuelles publiées par la BCE. 1 EUR = taux unités de la devise, exactement tel que publié - ni inverse ni taux croisé. Un jour sans publication (week-end, jour férié TARGET) répond 404, ou avec onOrBefore=true la publication précédente avec sa vraie date. Source : statistiques de la BCE ; la BCE publie ces taux à titre d’information uniquement et déconseille de s’en servir pour des transactions.

GET /api/v1/exchange-rates/latest GET /api/v1/exchange-rates?date={day}&onOrBefore=true GET /api/v1/exchange-rates/{currency}/daily?from={day}&to={day} GET /api/v1/exchange-rates/{currency}/averages?frequency=M|Q|A GET /api/v1/exchange-rates/currencies
Spécification OpenAPI →

Langues

ISO 639-3 / 639-5

Plus de 7 900 langues avec filtres (portée, type, code 639-1), recherche par code 639-1, 639-3 ou 639-2/B, les pays où chacune est parlée (statut officiel, part de la population), et les familles de langues.

GET /api/v1/languages?hasAlpha2=true GET /api/v1/languages/{code} GET /api/v1/languages/{code}/countries GET /api/v1/language-families
Spécification OpenAPI →

Écritures

ISO 15924

Les systèmes d'écriture (latin, cyrillique, arabe, han...) par code à quatre lettres, quelle que soit la casse, ou par code numérique.

GET /api/v1/scripts GET /api/v1/scripts/{code}
Spécification OpenAPI →

Régions

UN M49

Le monde, les continents et les sous-régions (Europe de l’Ouest, Afrique de l’Est...) sous forme d’arbre, et tous les pays d’une région, sous-régions comprises.

GET /api/v1/regions GET /api/v1/regions/{code} GET /api/v1/regions/{code}/countries
Spécification OpenAPI →

Listes de codes de la facture électronique

EN 16931 · Peppol

Les listes de codes derrière les factures électroniques EN 16931 et Peppol BIS, telles que publiées et reprises chaque jour : catégories de taxe (UNCL 5305), motifs d’exonération de TVA (VATEX), moyens de paiement, unités de mesure, types de document, schémas d’adresse électronique et d’identifiant de la Commission européenne, et les types de document, schémas d’identifiant de participant et processus Peppol d’OpenPeppol. La version en vigueur est servie par défaut ; les versions antérieures des listes EN 16931 (Genericode, depuis 2021) sont conservées, pour vérifier une ancienne facture avec version. Chaque réponse donne sa version, à enregistrer avec le code que vous utilisez.

GET /api/v1/code-lists GET /api/v1/code-lists/{listId}?version={version}&q={texte}&state={état} GET /api/v1/code-lists/{listId}/code?value={code}&version={version} GET /api/v1/code-lists/{listId}/versions
Spécification OpenAPI →

Taux de TVA de l’UE

TEDB · Commission européenne

Les taux de TVA des 27 États membres de la base « Taxes in Europe », tels que chaque ministère des Finances les fournit, repris chaque jour : taux normal, réduits, super-réduits et parking, exonérations, avec la catégorie TEDB, les codes NC (biens) et CPA (services) et le commentaire de l’État membre pour chaque taux. Demandez n’importe quelle date depuis le 1er janvier 2016 : vous obtenez la situation en vigueur à cette date. La Grèce est EL. Servis tels que publiés ; la Commission et les États membres déclinent toute responsabilité quant à ces informations.

GET /api/v1/vat-rates?country={code}&date={date} GET /api/v1/vat-rates?country={code}&cnCode={code} GET /api/v1/vat-rates/situations?country={code} GET /api/v1/vat-rates/categories
Spécification OpenAPI →

🌍 Recherche mondiale

Des sources qui couvrent tous les pays, interrogées en direct : lieux et adresses d'OpenStreetMap, et qui reçoit des factures électroniques sur le réseau Peppol. Les numéros de TVA européens sont vérifiés en direct dans VIES, le système de la Commission européenne. Les identifiants LEI viennent en direct de GLEIF. Les numéros de téléphone de tous les pays, vérifiés par une bibliothèque intégrée.

Numéros de téléphone

ITU-T E.164 · E.123 · RFC 3966 · libphonenumber

Vérifiez un numéro de téléphone tel qu’il a été saisi, dans n’importe quel pays : est-il possible et valide, fixe ou mobile, de quel pays, et ses formes - E.164 pour le stocker, internationale, nationale, lien tel: - avec la région ou la ville d’un numéro géographique, l’opérateur à qui la tranche a été attribuée (pas l’opérateur actuel après portabilité) et son fuseau horaire. Calculé avec libphonenumber de Google, intégrée à cette API : le numéro n’est envoyé nulle part et n’est stocké nulle part.

GET /api/v1/phone-numbers/check?number={numéro}&region={pays} GET /api/v1/phone-numbers/regions GET /api/v1/phone-numbers/regions/{region}/example?type=MOBILE
Spécification OpenAPI →

Recherche d’adresse

OpenStreetMap · Photon (ODbL)

Recherche en texte libre de lieux et d’adresses partout dans le monde, au fil de la frappe : maisons, rues, villes... les meilleurs d’abord, avec leur type et leur position WGS84. Orientez les résultats vers l’utilisateur avec lat et lon (ensemble), ou limitez-les à un pays. Les noms viennent dans la langue demandée quand l’instance la connaît ; la réponse dit quelle langue a été appliquée. Une maison belge porte aussi sa correspondance best : l’identifiant BeSt officiel à lire avec l’API des adresses belges, ou un statut disant pourquoi il n’y en a pas.

GET /api/v1/addresses/search?q={text}&countryCode={code}&lang={lang} GET /api/v1/addresses/search?q={text}&lat={lat}&lon={lon}
Spécification OpenAPI →

Identifiants LEI

GLEIF · ISO 17442 · ISO 20275

Le LEI de toute entreprise du monde, lu en direct chez GLEIF : dénomination et adresses, autorité d’enregistrement et identifiant (une entreprise belge se retrouve par son numéro d’entreprise), forme juridique ISO 20275 avec ses noms, statut d’enregistrement et prochaine date de renouvellement, et son groupe : parents directs et ultimes, filiales, ou le motif publié quand aucun parent n’est déclaré. Et la liste ISO 20275 des formes juridiques par pays. Données sous CC0. La fiche d’une entreprise belge porte aussi ses LEI. Cherchez par BIC pour trouver le LEI d’une banque.

GET /api/v1/leis/{lei} GET /api/v1/leis?name={texte}&country={code} GET /api/v1/leis?bic={bic} GET /api/v1/leis/{lei}/direct-parent GET /api/v1/leis/{lei}/direct-children GET /api/v1/entity-legal-forms?country={code}
Spécification OpenAPI →

Participants Peppol

Annuaire Peppol · Identifiants ISO 6523

Qui reçoit des factures électroniques et d’autres documents sur le réseau Peppol, dans le monde entier (8 millions de participants) : recherche par nom, pays ou identifiant, lecture d’un participant avec les entités qui se trouvent derrière et les types de documents acceptés. Interrogé en direct dans l’annuaire Peppol. Vérifiez votre client avant d’envoyer une facture électronique. Les entreprises belges ont un raccourci par numéro d’entreprise dans l’onglet Belgique, et leur fiche l’embarque déjà. Chaque type de document porte aussi son nom et son état codeList tirés des listes de codes Peppol. Avant d’envoyer, vérifiez le réseau lui-même : le SML Peppol dit si le participant est inscrit et quel SMP le détient, le SMP quels types de documents il accepte et par quel point d’accès (lu en direct, la signature du SMP relayée sans vérification).

GET /api/v1/peppol/participants?name={text}&country={code} GET /api/v1/peppol/participants/{participantId} GET /api/v1/peppol/participants/{participantId}/capabilities GET /api/v1/peppol/participants/{participantId}/capabilities/document?documentType={id}
Spécification OpenAPI →

Numéros de TVA européens

VIES · Commission européenne

Vérifie un numéro de TVA européen en direct dans VIES, qui interroge le registre de l’État membre : valide ou non, le nom et l’adresse que l’État publie et, si vous donnez votre propre numéro de TVA comme demandeur, le numéro de consultation VIES qui prouve la vérification. La Grèce est EL, l’Irlande du Nord XI ; le numéro peut être saisi avec son préfixe pays, des espaces ou des points. Chaque appel est une nouvelle vérification, rien n’est conservé.

GET /api/v1/vat-numbers/{countryCode}/{vatNumber} GET /api/v1/vat-numbers/{countryCode}/{vatNumber}?requesterCountryCode={code}&requesterVatNumber={number} GET /api/v1/vat-numbers/member-states

Pas de formulaire de test ici : VIES ne peut servir qu’à confirmer les numéros de TVA de vos propres clients et fournisseurs, et sa réponse n’est ni un avis juridique ni, à elle seule, un droit à l’exonération de TVA (avertissement de VIES).

Spécification OpenAPI →

🇧🇪 Belgique

Tout ce qui concerne la Belgique se trouve sous /api/v1/bel/ : les entreprises de la BCE, leurs comptes annuels à la Banque nationale et les registres d’adresses officiels.

Entreprises

BCE/KBO Open Data · NACE-BEL

Toutes les entreprises inscrites à la Banque-Carrefour des Entreprises. Saisissez un numéro de TVA ou d’entreprise comme le font vos utilisateurs (sous toutes ses formes), validez-le (chiffres de contrôle, inscrite, active), ou laissez-les choisir dans une autocomplétion sur le nom ; lisez ensuite dénominations, forme juridique, adresses, contacts, activités, unités d’établissement et succursales, et les listes de codes BCE pour vos menus déroulants. La fiche dit aussi si l’entreprise reçoit des factures électroniques Peppol.

GET /api/v1/bel/enterprises/{number} GET /api/v1/bel/enterprises/{number}/validation GET /api/v1/bel/enterprises?name={text} GET /api/v1/bel/enterprises/{number}/establishments GET /api/v1/bel/kbo-codes/{category} GET /api/v1/bel/enterprises/{number}/peppol GET /api/v1/bel/enterprises/{number}/peppol-capabilities
Spécification OpenAPI →

Codes bancaires belges

Liste du Protocole (BNB) · IBAN ISO 13616 · BIC ISO 9362

Quelle banque se trouve derrière un IBAN belge, et quel est son BIC ? Les trois premiers chiffres de tout numéro de compte belge sont un code d’identification bancaire, attribué par le Protocole hébergé par la Banque nationale de Belgique. Vérifiez un IBAN (longueur, chiffres de contrôle ISO, chiffres de contrôle belges) et obtenez sa banque, lisez un code ou tous les codes d’un BIC (un BIC de 8 caractères trouve aussi ses BIC d’agence). La liste de la BNB est reprise chaque jour et servie telle que publiée : bicAsPublished garde chaque cellule, status distingue les codes libres et indisponibles.

GET /api/v1/bel/ibans/{iban} GET /api/v1/bel/bank-codes/{code} GET /api/v1/bel/bank-codes?bic={bic}
Spécification OpenAPI →

Plan comptable belge

PCMN / MAR · CNC/CBN

Le plan comptable minimum normalisé belge (PCMN / MAR) des entreprises, et celui des associations et fondations, en français, néerlandais, anglais et allemand, tel que la Commission des Normes Comptables publie leur texte coordonné, rechargé chaque jour. Chaque compte vient avec son niveau, le compte dont il relève, ses notes avec leur texte et, pour la classe 0, le texte sur son contenu ; le plan des associations donne aussi la rubrique du schéma des comptes annuels. Chaque langue est servie telle que publiée, défauts de mise en page de la source compris.

GET /api/v1/bel/chart-of-accounts?type=&lang=&parent=&level= GET /api/v1/bel/chart-of-accounts/{code} GET /api/v1/bel/chart-of-accounts/notes
Spécification OpenAPI →

Taxonomies des comptes annuels

Centrale des bilans BNB · XBRL

Les taxonomies XBRL que la Banque nationale de Belgique publie pour les comptes annuels, chaque version depuis 2015, reprises telles que publiées : les modèles (complet, abrégé, micro ; avec et sans capital ; associations et fondations), leurs sections, tableaux, codes de rubrique et libellés en français, néerlandais, allemand et anglais, le fait qu’un dépôt déclare à chaque cellule (concept, type, période, membres de dimensions) et les contrôles de la BNB avec leurs messages. Les taxonomies de 2015 à 2020 renvoient aussi au compte du PCMN de chaque rubrique. La version applicable à un exercice suit le guide technique de la BNB.

GET /api/v1/bel/annual-accounts-taxonomies GET /api/v1/bel/annual-accounts-taxonomies/{version}/models GET /api/v1/bel/annual-accounts-taxonomies/{version}/models/{model}/sections GET /api/v1/bel/annual-accounts-taxonomies/{version}/models/{model}/checks GET /api/v1/bel/annual-accounts-taxonomies/{version}/dimensions
Spécification OpenAPI →

Comptes annuels

Centrale des bilans de la BNB

Les comptes annuels que chaque entreprise belge dépose à la Banque nationale de Belgique : la liste des dépôts (exercice, modèle, langue) des trois dernières années, et les documents (PDF, XBRL, JSON) relayés depuis la BNB. Demandez une fois history=complete pour rapatrier tous les dépôts depuis 1978 (quelques secondes la première fois).

GET /api/v1/bel/enterprises/{number}/annual-accounts GET /api/v1/bel/enterprises/{number}/annual-accounts?history=complete GET /api/v1/bel/annual-accounts/{reference} GET /api/v1/bel/annual-accounts/{reference}/pdf
Spécification OpenAPI →

Adresses

BeSt Address · BOSA et les trois régions (CC BY 4.0)

Complétez une adresse belge en trois appels guidés - commune (par code postal ou par nom), rue, numéro et boîte - puis lisez l’adresse complète avec son identifiant BeSt officiel, sa position WGS84, son statut et ses dates de validité. Les identifiants sont les URI régionales publiées par BeSt : renvoyez-les tels que reçus. Aucun joker n’est nécessaire (ni accepté) : le texte saisi correspond au début d’un mot ou à une partie du nom, dans n’importe quelle langue. Interrogé en direct dans les registres d’adresses fédéral et régionaux.

GET /api/v1/bel/addresses/municipalities?q={text} GET /api/v1/bel/addresses/streets?postCode={code}&name={text} GET /api/v1/bel/addresses/house-numbers?streetId={id}&houseNumber={digits} GET /api/v1/bel/addresses?id={addressId}

        Spécification OpenAPI →

        🇫🇷 France

        Tout ce qui concerne la France se trouve sous /api/v1/fra/ : les unités légales et les établissements du répertoire Sirene de l’Insee.

        Entreprises françaises

        INSEE Sirene · SIREN · SIRET · NAF

        Toute unité légale (SIREN) et tout établissement (SIRET) du répertoire Sirene de l’Insee, lus en direct : dénomination, catégorie juridique, activité principale avec sa nomenclature (NAF rév. 2, NAF 2025 à partir de janvier 2027), état administratif, siège, adresses et l’historique de chaque période. Recherche par nom, activité, catégorie juridique ou code postal. Les champs que l’Insee retient pour une personne physique qui s’y est opposée restent vides. Données sous Licence Ouverte 2.0 ; l’Insee autorise 30 requêtes par minute, les fiches sont donc gardées une heure en cache.

        GET /api/v1/fra/enterprises/{siren} GET /api/v1/fra/enterprises?name={texte} GET /api/v1/fra/enterprises/{siren}/establishments GET /api/v1/fra/establishments/{siret} GET /api/v1/fra/establishments?name={texte}&postCode={code}
        Spécification OpenAPI →

        Démarrer

        Sans inscription ni clé : envoyez une requête, recevez du JSON. Un compte développeur gratuit relève vos limites.

        1Appelez un endpoint

        Tous les endpoints sont sous https://publicapi.axitam.net/api/v1. La vérification des numéros de TVA européens se trouve uniquement sous https://vies.publicapi.axitam.net/api/v1.

        curl "https://publicapi.axitam.net/api/v1/countries/BE?lang=fr"

# {"alpha2":"BE","alpha3":"BEL","numeric":"056","name":"Belgique",
#  "officialName":"Royaume de Belgique","commonName":null,"flag":"🇧🇪"}
        curl https://publicapi.axitam.net/api/v1/bel/enterprises/0420.254.973

# {"enterpriseNumber":"0420.254.973","vatNumber":"BE0420254973","status":{"code":"AC",...},
#  "denominations":[{"value":"AXITAM",...}],"addresses":[...],"activities":[...]}
        curl https://publicapi.axitam.net/api/v1/bel/enterprises/0420.254.973/annual-accounts

# {"enterpriseNumber":"0420254973","historyComplete":false,"annualAccounts":[{"referenceNumber":"2025-00555958",
#   "depositDate":"2025-10-31","exerciseStart":"2024-01-01","exerciseEnd":"2024-12-31","modelType":"m87-f",...}]}
        curl https://publicapi.axitam.net/api/v1/peppol/participants/0208:0420254973

# {"participantId":{"scheme":"iso6523-actorid-upis","value":"0208:0420254973"},
#  "entities":[{"names":[{"name":"AXITAM"}],"countryCode":"BE",...}],"documentTypes":[...]}
        curl "https://publicapi.axitam.net/api/v1/bel/addresses/streets?postCode=1000&name=loi"

# [{"streetId":"https://databrussels.be/id/streetname/1679/1","name":{"nl":"Wetstraat","fr":"Rue de la Loi","de":null},
#   "municipality":{"municipalityId":"https://databrussels.be/id/municipality/21004/7","nisCode":"21004","name":{...}}},...]
        curl "https://publicapi.axitam.net/api/v1/addresses/search?q=rue%20de%20la%20loi%2016%20bruxelles&countryCode=BE&lang=fr"

# {"query":"rue de la loi 16 bruxelles","language":"fr","results":[{"label":"Rue de la Loi 16, 1000 Bruxelles, Belgique",
#   "type":"house","street":"Rue de la Loi","houseNumber":"16","postCode":"1000","city":"Bruxelles","countryCode":"BE",...}]}
        curl https://vies.publicapi.axitam.net/api/v1/vat-numbers/member-states

# {"available":true,"memberStates":[{"countryCode":"AT","availability":"AVAILABLE"},
#   {"countryCode":"BE","availability":"AVAILABLE"},...,{"countryCode":"XI","availability":"AVAILABLE"}]}
        curl "https://publicapi.axitam.net/api/v1/code-lists/en16931-5305/code?value=AE"

# {"listId":"en16931-5305","listVersion":"2026-05-15",
#  "code":{"code":"AE","name":"VAT Reverse charge","remark":"VAT reverse charge","attributes":{}}}
        curl https://publicapi.axitam.net/api/v1/leis/549300CWRXC5EP004533

# {"lei":"549300CWRXC5EP004533","entity":{"legalName":{"name":"PROXIMUS","language":"nl"},"registeredAt":"RA000025",
#   "registeredAs":"0202.239.951","legalForm":{"code":"R85P","names":[...]},...},"registration":{"status":"ISSUED",...}}
        curl "https://publicapi.axitam.net/api/v1/vat-rates?country=BE&type=STANDARD"

# [{"country":"BE","requestedDate":"2026-09-28","situationDate":"2026-07-01",
#   "rates":[{"type":"STANDARD","rateType":"DEFAULT","value":21.0,"category":null,...}]}]

        2Obtenez les noms dans votre langue

        Ajoutez lang avec une étiquette de langue (fr, nl-BE, pt-BR, ja...). Une variante régionale se rabat sur sa langue, puis sur l'anglais.

        curl "https://publicapi.axitam.net/api/v1/countries/BE?lang=nl-BE"     # "name":"België"
curl "https://publicapi.axitam.net/api/v1/countries/BE/subdivisions?lang=fr"
curl "https://publicapi.axitam.net/api/v1/currencies/978?lang=fr"      # "name":"Euro"
curl "https://publicapi.axitam.net/api/v1/languages/fr?lang=fr"        # "name":"Français"
curl "https://publicapi.axitam.net/api/v1/scripts/Latn"

        3Gérez les erreurs

        Les erreurs utilisent les codes HTTP standard (400 pour un code invalide, 404 pour un code inconnu, 429 au-delà de votre limite d'usage) et toujours le même corps : un code d'erreur stable et un correlationId à mentionner si vous nous contactez.

        curl -i https://publicapi.axitam.net/api/v1/countries/ZZ

# HTTP/2 404
# {"code":"COUNTRY_NOT_FOUND","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i https://publicapi.axitam.net/api/v1/bel/enterprises/123

# HTTP/2 400
# {"code":"INVALID_ENTERPRISE_NUMBER","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i https://publicapi.axitam.net/api/v1/peppol/participants/0208:0999999922

# HTTP/2 404
# {"code":"PEPPOL_PARTICIPANT_NOT_FOUND","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i "https://publicapi.axitam.net/api/v1/bel/addresses/streets?postCode=1000&name=lo*"

# HTTP/2 400
# {"code":"INVALID_REQUEST","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i "https://publicapi.axitam.net/api/v1/addresses/search?q=paris&lat=48.85"

# HTTP/2 400 (lat sans lon)
# {"code":"INVALID_ARGUMENT","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i https://vies.publicapi.axitam.net/api/v1/vat-numbers/GR/123456789

# HTTP/2 400 (la Grèce est EL dans VIES)
# {"code":"VAT_COUNTRY_NOT_SUPPORTED","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i https://publicapi.axitam.net/api/v1/code-lists/en16931-9999

# HTTP/2 404
# {"code":"CODE_LIST_NOT_FOUND","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i https://publicapi.axitam.net/api/v1/leis/549300CWRXC5EP004534

# HTTP/2 400 (les deux derniers chiffres contrôlent les autres)
# {"code":"INVALID_LEI","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}
        curl -i "https://publicapi.axitam.net/api/v1/vat-rates?country=GR"

# HTTP/2 400 (la Grèce est EL dans TEDB)
# {"code":"VAT_COUNTRY_NOT_SUPPORTED","correlationId":"54046f8d-6bc9-44bf-b4fe-ea4377737f97"}

        4Envoyez votre clé d'API

        Les appels anonymes sont limités par adresse IP. Avec un compte développeur gratuit, envoyez votre clé dans l'en-tête X-API-Key : les limites s'appliquent alors par clé, et elles sont plus élevées (voir Limites d'usage).

        curl -H "X-API-Key: pk_live_..." https://publicapi.axitam.net/api/v1/data-sources

# X-RateLimit-Limit: 30
# une clé inconnue ou révoquée : HTTP 401 {"code":"INVALID_API_KEY",...}

        Documentation

        Parcourez tous les endpoints de manière interactive, ou importez une spécification OpenAPI dans vos outils pour générer un client.

        Swagger UIDocumentation interactive de toutes les API PaysSpécification OpenAPI 3 (JSON) DevisesSpécification OpenAPI 3 (JSON) Taux de change (BCE)Spécification OpenAPI 3 (JSON) Listes de codes de la facture électroniqueSpécification OpenAPI 3 (JSON) Taux de TVA de l’UE (TEDB)Spécification OpenAPI 3 (JSON) Codes bancaires belges (BNB)Spécification OpenAPI 3 (JSON) - groupe belgium Plan comptable belge (CNC)Spécification OpenAPI 3 (JSON) - groupe belgium Taxonomies des comptes annuels (BNB)Spécification OpenAPI 3 (JSON) - groupe belgium France (Sirene de l’Insee)Spécification OpenAPI 3 (JSON) Numéros de téléphoneSpécification OpenAPI 3 (JSON) LanguesSpécification OpenAPI 3 (JSON) ÉcrituresSpécification OpenAPI 3 (JSON) RégionsSpécification OpenAPI 3 (JSON) Belgique (BCE/KBO, BNB, BeSt Address)Spécification OpenAPI 3 (JSON) Recherche d’adresse (monde entier)Spécification OpenAPI 3 (JSON) Participants PeppolSpécification OpenAPI 3 (JSON) Identifiants LEI (GLEIF)Spécification OpenAPI 3 (JSON) Numéros de TVA européens (VIES)Spécification OpenAPI 3 (JSON) Sources des donnéesSpécification OpenAPI 3 (JSON)

        Limites d'usage et un hôte par source

        L'API est gratuite et sans clé. Pour qu'elle reste rapide pour tout le monde, chaque client (adresse IP) est limité : 10 requêtes par seconde avec des rafales de 20 sur tous les chemins, 2 par seconde sur les chemins Peppol (la limite de l'annuaire Peppol lui-même), 1 par seconde quand un document de comptes annuels est relayé depuis la BNB, 5 par seconde sur la recherche d’adresse mondiale (l’instance Photon publique demande un usage raisonnable), 2 par seconde sur la vérification des numéros de TVA européens (VIES limite les requêtes simultanées), 5 par seconde sur les chemins LEI (l’API GLEIF est partagée), 1 par seconde sur les chemins français (l’Insee autorise 30 requêtes par minute pour tous les appelants ensemble). Une requête au-delà de la limite reçoit HTTP 429 avec le code d'erreur RATE_LIMITED et un en-tête Retry-After ; chaque réponse limitée porte X-RateLimit-Limit et X-RateLimit-Remaining.

        Besoin de plus ? Créez un compte développeur gratuit (confirmation de l'e-mail, puis une courte approbation manuelle), souscrivez au palier gratuit et envoyez votre clé d'API dans l'en-tête X-API-Key : 30 requêtes par seconde avec des rafales de 60 sur chaque hôte, par clé plutôt que par adresse IP. Les limites par chemin ci-dessus restent d'application ; une clé inconnue ou révoquée est refusée avec 401 INVALID_API_KEY.

        Obtenir une clé d'API

        Chaque source est aussi servie seule sur son propre hôte, avec les mêmes chemins et formats :

        HôteContenuSources de données
        publicapi.axitam.netTout ce qui suit sauf la vérification des numéros de TVA européens, sur un seul hôteiso-codes, cldr, ecb-exchange-rates, kbo-open-data, nbb-cbso, peppol-directory, best-address, photon, en16931-code-lists, peppol-code-lists, gleif, tedb-vat-rates, nbb-bank-codes, insee-sirene, libphonenumber, cnc-pcmn, nbb-cbso-taxonomy
        cbe.publicapi.axitam.netEntreprises belges (BCE/KBO)kbo-open-data
        nbb.publicapi.axitam.netComptes annuels belges (BNB)nbb-cbso
        peppol.publicapi.axitam.netParticipants Peppol (en direct)peppol-directory
        be.publicapi.axitam.netTout ce qui est belge : entreprises, comptes annuels, Peppol, adresses, recherche d’adresse, LEI, codes bancaires, plan comptable, taxonomies des comptes annuelskbo-open-data, nbb-cbso, peppol-directory, best-address, photon, gleif, nbb-bank-codes, cnc-pcmn, nbb-cbso-taxonomy
        address.publicapi.axitam.netAdresses belges et recherche d’adresse mondiale (BeSt Address, Photon, en direct)best-address, photon
        refdata.publicapi.axitam.netPays, devises, langues, écritures, régions, taux de changeiso-codes, cldr, ecb-exchange-rates
        vies.publicapi.axitam.netVérification des numéros de TVA européens (VIES, en direct), sur cet hôte uniquementvies
        codelists.publicapi.axitam.netListes de codes de la facture électronique (EN 16931, Peppol)en16931-code-lists, peppol-code-lists
        lei.publicapi.axitam.netIdentifiants LEI et formes juridiques ISO 20275 (GLEIF, en direct)gleif
        vat.publicapi.axitam.netTaux de TVA de l’UE (TEDB, repris chaque jour)tedb-vat-rates
        banks.publicapi.axitam.netCodes bancaires belges et vérification d’IBAN (BNB, repris chaque jour)nbb-bank-codes
        fr.publicapi.axitam.netEntreprises et établissements français (Sirene de l’Insee, en direct)insee-sirene
        phone.publicapi.axitam.netVérification des numéros de téléphone (libphonenumber, intégrée)libphonenumber
        pcmn.publicapi.axitam.netPlan comptable minimum normalisé belge (CNC/CBN, rechargé chaque jour)cnc-pcmn
        taxonomy.publicapi.axitam.netTaxonomies XBRL des comptes annuels de la BNB depuis 2015 (reprises chaque jour)nbb-cbso-taxonomy

        Bêta publique

        L'AXITAM Public API est en bêta : elle est disponible et tenue à jour, mais les endpoints et les formats de réponse peuvent encore évoluer avant la version 1.0. D'autres données de référence (codes TVA d'autres pays, validation des numéros de téléphone...) sont en préparation.

        Une question, une idée, un retour ? Nous serons ravis de vous lire.

        Contacter AXITAM