Skip to content

API Adresse (Base Adresse Nationale - BAN) API

by Institut national de l'information géographique et forestière

No authHTTPSGovernment
Open documentation ↗

Overview

L' API Adresse permet d'interroger facilement la Base Adresse Nationale. ### A quoi sert l'API Adresse ? En intégrant l'API dans votre système d'information, vous pouvez facilement rechercher une adresse et : - faire de l'autocomplétion et de la vérification d'adresse ; - géolocaliser une adresse sur une carte ; - faire une recherche géographique inversée (trouver la rue la plus proche de coordonnées géographiques). ### Données disponibles | Nom | Description | | ---------------- | ------------------------------------------------------------------ | | type | type de résultat trouvé : rue, numéro de plaque, lieu-dit, commune | | numéro de plaque | numéro avec indice de répétition éventuel (bis, ter, A, B) | | nom | numéro éventuel et nom de voie ou lieu dit | | code postal | code postal | | code de ville | code INSEE de la commune | | commune | nom de la commune | | arrondissement | nom de l’arrondissement (Paris/Lyon/Marseille) | | context | n° de département, nom de département et de région | ### En savoir plus La [Base Adresse Nationale](https://adresse.data.gouv.fr) est constituée par la collaboration entre: - des acteurs nationaux tels que la DINUM, l’[IGN](http://ign.fr/) et l’[ANCT](https://agence-cohesion-territoires.gouv.fr), - des acteurs locaux tels que les collectivités et en particulier les communes qui ont la compétence de l’adressage. [Lien des documentations supplémentaires](https://adresse.data.gouv.fr/api-doc/adresse) ### Partenaires de l'API - IGN - Agence n

API Adresse (Base Adresse Nationale - BAN) is a government API from Institut national de l'information géographique et forestière. It needs no API key. It is served over HTTPS.

At a glance

Authentication
No auth
HTTPS
Yes
CORS
Unknown
Category
Government
Base URL
https://data.geopf.fr/geocodage/

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://data.geopf.fr/geocodage/" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://data.geopf.fr/geocodage/", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://data.geopf.fr/geocodage/",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Questions

Does the API Adresse (Base Adresse Nationale - BAN) API need an API key?

No. The API Adresse (Base Adresse Nationale - BAN) API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the API Adresse (Base Adresse Nationale - BAN) API support HTTPS?

Yes, the API Adresse (Base Adresse Nationale - BAN) API is served over HTTPS.

What are alternatives to the API Adresse (Base Adresse Nationale - BAN) API?

Other Government APIs include EPA, UK Companies House, Open Government, Canada, Federal Register, Census.gov.

Compare alternatives →

Listed from data.gouv.fr (Licence Ouverte).