Base Adresse Nationale : vérifier une adresse en un clic
Une adresse telle qu'elle est écrite dans votre fichier, fautes comprises. La réponse dit si elle existe dans la Base Adresse Nationale, où elle est et dans quelle commune, sans compte.
Essayez
Résultat
1 correspondance
pour 20 avenue de Ségur 75007 Paris, la plus proche en premier
-
20 Avenue de Ségur, 75007 Paris 7e Arrondissement
Correspondance certaine 1.00
Code INSEE 75107, identifiant BAN 75107_8909_00020.
Position 48.850699, 2.308628, précision parcelle, Lambert 93 649 266, 6 861 406.
Source : Base Adresse Nationale (IGN, open data), à jour. Service POST /address/verify
de l'API TrustyData : une validation géographique, pas une homologation postale.
Ce qu'est la Base Adresse Nationale
La Base Adresse Nationale (BAN) est la base d'adresses de référence de l'État, pilotée par l'IGN et publiée en open data. Elle réunit près de 26 millions d'adresses, chacune avec sa position et le code INSEE de sa commune. Les communes y écrivent elles-mêmes leurs adresses ; c'est la source que les secours, les opérateurs et les administrations partagent.
Une adresse, une position, un code INSEE
Vérifier une adresse dans la BAN, c'est la rapprocher d'une adresse qui existe, et recevoir en retour sa forme officielle, ses coordonnées et sa commune. L'outil rend les lignes postales prêtes à afficher, le code INSEE et l'identifiant BAN, stable dans le temps.
Certaine, probable, aucune : lire le verdict
Certaine : la BAN contient cette adresse, aux fautes de frappe et aux abréviations près. Probable : la BAN a trouvé une adresse proche, mais pas la vôtre à coup sûr ; c'est le cas d'un lieu-dit sans numéro ou d'un numéro absent de la voie. Vérifiez la commune et le numéro avant de l'accepter. Aucune : rien d'assez proche ; l'adresse est mal écrite, ou elle n'existe pas encore dans la base.
Ce que la BAN contient, et ce qu'elle ne contient pas
| Dans la BAN | Pas dans la BAN |
|---|---|
| Le numéro, son indice (bis, ter), la voie et son type | Le CEDEX, la boîte postale, la case CS ou TSA : des mentions d'acheminement, pas des lieux |
| Le lieu-dit et le hameau, avec ou sans numéro | L'étage, le bâtiment, l'escalier, la porte |
| La commune, son code INSEE, son code postal | L'occupant : ni nom, ni « chez », ni service |
| La position, avec sa précision : parcelle, entrée, voie ou commune | Les adresses hors de France |
Ces mentions absentes ne sont pas une faute de la BAN : elles décrivent qui reçoit le courrier, pas où est le bâtiment. Dans un fichier, elles vont dans un champ de complément, isolé avant le rapprochement. L'article Adresses erronées : 7 pièges d'un fichier français donne un test pour chacune.
Pour le dire nettement : TrustyData n'est pas un outil de RNVP. Pour une étiquette postale homologuée, il faut un prestataire disposant d'un logiciel certifié ; pour savoir si une adresse existe, où elle est et dans quelle commune, le rapprochement géographique à la BAN suffit.
Et pour tout un fichier ?
La même vérification existe dans l'API, une adresse par requête, à intégrer dans un script ou un pipeline. Le verdict et le score permettent de trier : les certaines passent, les probables se relisent, les absentes se corrigent à la source.
# Une adresse libre en entrée ; chaque correspondance porte verdict, score, lignes postales, code INSEE, position
curl -X POST "https://api.trustydata.app/services/v1/address/verify" \
-H "Authorization: Bearer $TRUSTYDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "20 av de segur paris", "max_results": 3}'
# "verdict": "match_exact", "score": 0.982, "ligne_voie": "20 Avenue de Ségur", "code_insee": "75107"
- Vérifier les adresses d'un formulaire ou d'un fichier, le cas d'usage
- Géocoder un fichier d'adresses, et quoi faire du quart qui ne se place pas
- Documentation de l'API
- Démo pour développeurs, avec le code cURL et Python
- Créer une clé gratuite
Questions fréquentes
Où télécharger la Base Adresse Nationale ?
Sur adresse.data.gouv.fr, en open data sous licence ouverte, par département ou France entière, en CSV ou en GeoJSON. Le fichier change toutes les semaines : une copie locale vieillit, l'API interroge la base à jour, une adresse par requête.
Mon adresse n'est pas dans la BAN, que faire ?
Vérifier d'abord la commune et le numéro : la plupart des absences sont des fautes de saisie ou un code postal qui désigne une autre commune. Si l'adresse existe vraiment et manque, c'est la commune qui la crée dans sa base adresse locale ; elle remonte ensuite dans la BAN.
La BAN remplace-t-elle le référentiel de La Poste ?
Non, les deux ne répondent pas à la même question. La BAN dit si une adresse existe, où elle est et dans quelle commune : c'est une validation géographique. L'homologation postale d'une étiquette (RNVP) relève de prestataires certifiés, et TrustyData n'en est pas un.
Quelle différence avec l'API Adresse gratuite de l'État ?
La même BAN derrière. L'API Adresse géocode gratuitement, avec un plafond de requêtes par adresse IP et sans verdict. Cet outil rend un verdict certain, probable ou aucun, les lignes postales prêtes à afficher et le code INSEE ; l'API TrustyData ajoute l'IRIS et le carreau statistique.
Pour aller plus loin
- BAN, BAL, id BAN dans le glossaire
- API Adresse de l'État : ses limites, et quand passer à une alternative
- Adresses erronées : 7 pièges d'un fichier français, un test par piège
- Trouver le code INSEE d'une commune, l'outil voisin
- Tracer l'isochrone d'une adresse, ce qu'on atteint en quinze minutes
- Toutes les ressources
Essayer l'API sans compte
Les démos publiques appellent l'API en direct ; le plan Discovery est gratuit.