Register record·API·FR·Updated MonthlyUNVERIFIED

B

Base Adresse Locale

Name: Base Adresse Locale
Creator: opendatasoft

APIQuery nowOpen workbench🇫🇷France

La Base Adresse Nationale ( BAN ) est la base de données de référence des adresses officiellement reconnues par l’Administration. La complétude de cette base permet que les services soient délivrés au bon endroit. Cette base nationale est construite par l’addition des Bases Adresses Locales (BAL)...

⬇ Export CSV List records Select & filter API base URL Read the docs

Data schema (23 fields)

Filterable via the API (22)

cle_interopnumerosuffixevoie_nomcommune_nomxylonglatsourcedate_der_majpositionid_ban_communeid_ban_toponymeid_ban_adressecommune_inseecommune_deleguee_inseecommune_deleguee_nomlieudit_complement_nomcad_parcellescertification_communevoie_nom_oci

Click a field to see example values.

Fill	Field	Type	Description
100%	cle_interopCle interop	text	La clé d'interopérabilité est composée : ● code INSEE sur 5 caractères ● code de voie (l’identifiant unique de voie fourni par le guichet unique national, à défaut le code FANTOIR DGFiP sur 4 caractères) ● numéro d’adresse sur 5 caractères préfixé si besoin par des zéros ● suffixe (bis / ter / qua / qui / a / b / c...). Les indices de répétition “bis, ter…” seront codés sur 3 caractères et les autres (A, B, C, A1, B2...) seront mis en minuscules sans obligation du nombre de caractères. ● chaque item étant séparé par le caractère underscore “_” ● le tout en minuscules
100%	numero	int	Numéro d'adresse dans la voie. Dans le cas des voies sans adresse la valeur “99999” est renseignée.
8.3%	suffixe	text	Suffixe éventuel du numéro (composé d'un indice de répétition et/ou d'un complément d'adresse) ● l’indice de répétition = - “BIS, TER, QUATER, QUINQUIES” normalisés sur 3 caractères en minuscules : “bis, ter, qua, qui” - “A, B, C” normalisés sur 1 caractère en minuscule : “a, b, c” ● le complément d'adresse = nom d'entrée d'immeuble (A, B, C, 1, 2, 3, A1, B3, Orion, Les Mimosas) normalisé en minuscules sans espaces. Ex : “a, b, a1, b3, lesmimosas”
100%	voie_nomVoie nom	text	Nom de la voie d'appartenance du numéro. Cet attribut est composé de la concaténation du type et du nom de la voie en majuscules et minuscules accentuées
100%	commune_nomCommune nom	text	Commune d'appartenance du numéro
100%	x	double	Coordonnée x en Lambert 93
100%	y	double	Coordonnée y en Lambert 93
100%	long	double	Longitude en WGS84
100%	lat	double	Latitude en WGS84
99.3%	source	text	Nom de l'entité ayant créé l'adresse
100%	date_der_majDate der maj	date	Date de la dernière mise à jour connue de la donnée
99.3%	position	text	Précision géométrique du numéro : - délivrance postale - entrée - bâtiment - cage d'escalier - logement - parcelle - segment - service technique
100%	id_ban_communeId ban commune	text	—
100%	id_ban_toponymeId ban toponyme	text	—
99.3%	id_ban_adresseId ban adresse	text	—
100%	commune_inseeCommune insee	int	—
0%	commune_deleguee_inseeCommune deleguee insee	text	—
0%	commune_deleguee_nomCommune deleguee nom	text	—
0%	lieudit_complement_nomLieudit complement nom	text	—
99.3%	cad_parcellesCad parcelles	text	—
—	certification_communeCertification commune	int	—
—	voie_nom_ociVoie nom oci	text	—
—	point_geoPoint geo	geo_point_2d	—

Schema captured from opendatasoft 2 hours ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (5 records)

Record 1x: 585454.96 · y: 6275360

{
  "x": 585454.96,
  "y": 6275360,
  "lat": 43.5680503,
  "long": 1.5825344,
  "numero": 5,
  "source": "commune",
  "suffixe": null,
  "position": "bâtiment",
  "voie_nom": "Allée des Fenaisons",
  "point_geo": {
    "lat": 43.5680503,
    "lon": 1.5825344
  },
  "cle_interop": "31003_0025_00005",
  "commune_nom": "Aigrefeuille",
  "date_der_maj": "2023-10-30",
  "voie_nom_oci": null,
  "cad_parcelles": "310003000ZD0095",
  "commune_insee": 31003,
  "id_ban_adresse": "57ded7b3-6b67-40ac-a411-8c2787a5c74b",
  "id_ban_commune": "29add663-dd26-48e0-9a3b-47ddb54ffedc",
  "id_ban_toponyme": "020e0b52-f749-48d8-bf5f-87a5c5bebd25",
  "commune_deleguee_nom": null,
  "certification_commune": 1,
  "commune_deleguee_insee": null,
  "lieudit_complement_nom": null
}

Record 2x: 585438.47 · y: 6275353.69

{
  "x": 585438.47,
  "y": 6275353.69,
  "lat": 43.5679908,
  "long": 1.5823318,
  "numero": 3,
  "source": "commune",
  "suffixe": null,
  "position": "bâtiment",
  "voie_nom": "Allée des Fenaisons",
  "point_geo": {
    "lat": 43.5679908,
    "lon": 1.5823318
  },
  "cle_interop": "31003_0025_00003",
  "commune_nom": "Aigrefeuille",
  "date_der_maj": "2023-10-30",
  "voie_nom_oci": null,
  "cad_parcelles": "310003000ZD0091",
  "commune_insee": 31003,
  "id_ban_adresse": "c6c0d631-f378-4b57-baed-6423223f45c6",
  "id_ban_commune": "29add663-dd26-48e0-9a3b-47ddb54ffedc",
  "id_ban_toponyme": "020e0b52-f749-48d8-bf5f-87a5c5bebd25",
  "commune_deleguee_nom": null,
  "certification_commune": 1,
  "commune_deleguee_insee": null,
  "lieudit_complement_nom": null
}

Record 3x: 585454.3 · y: 6275335.37

{
  "x": 585454.3,
  "y": 6275335.37,
  "lat": 43.5678286,
  "long": 1.5825318,
  "numero": 4,
  "source": "commune",
  "suffixe": null,
  "position": "bâtiment",
  "voie_nom": "Allée des Fenaisons",
  "point_geo": {
    "lat": 43.5678286,
    "lon": 1.5825318
  },
  "cle_interop": "31003_0025_00004",
  "commune_nom": "Aigrefeuille",
  "date_der_maj": "2023-10-30",
  "voie_nom_oci": null,
  "cad_parcelles": "310003000ZD0090",
  "commune_insee": 31003,
  "id_ban_adresse": "d7c70e7b-71eb-4d96-a486-dfb835627caa",
  "id_ban_commune": "29add663-dd26-48e0-9a3b-47ddb54ffedc",
  "id_ban_toponyme": "020e0b52-f749-48d8-bf5f-87a5c5bebd25",
  "commune_deleguee_nom": null,
  "certification_commune": 1,
  "commune_deleguee_insee": null,
  "lieudit_complement_nom": null
}

Record 4x: 586280.09 · y: 6274357.79

{
  "x": 586280.09,
  "y": 6274357.79,
  "lat": 43.5591672,
  "long": 1.592964,
  "numero": 5,
  "source": "commune",
  "suffixe": null,
  "position": "bâtiment",
  "voie_nom": "Route de la Saune",
  "point_geo": {
    "lat": 43.5591672,
    "lon": 1.592964
  },
  "cle_interop": "31003_0150_00005",
  "commune_nom": "Aigrefeuille",
  "date_der_maj": "2023-10-30",
  "voie_nom_oci": null,
  "cad_parcelles": "310003000ZB0089",
  "commune_insee": 31003,
  "id_ban_adresse": "df0685aa-2764-45cc-9024-917238d57475",
  "id_ban_commune": "29add663-dd26-48e0-9a3b-47ddb54ffedc",
  "id_ban_toponyme": "109a94fa-b239-4954-b833-0ccc1a19b39d",
  "commune_deleguee_nom": null,
  "certification_commune": 1,
  "commune_deleguee_insee": null,
  "lieudit_complement_nom": null
}

Record 5x: 586170.33 · y: 6275722.37

{
  "x": 586170.33,
  "y": 6275722.37,
  "lat": 43.5714253,
  "long": 1.5913051,
  "numero": 1,
  "source": "commune",
  "suffixe": null,
  "position": "bâtiment",
  "voie_nom": "Chemin des Blés",
  "point_geo": {
    "lat": 43.5714253,
    "lon": 1.5913051
  },
  "cle_interop": "31003_0021_00001",
  "commune_nom": "Aigrefeuille",
  "date_der_maj": "2023-10-30",
  "voie_nom_oci": null,
  "cad_parcelles": "310003000ZA0536",
  "commune_insee": 31003,
  "id_ban_adresse": "5e743f8c-b7ac-4be3-b010-f68702af0a97",
  "id_ban_commune": "29add663-dd26-48e0-9a3b-47ddb54ffedc",
  "id_ban_toponyme": "16bafec9-66fa-4f84-8003-2205a0319bd0",
  "commune_deleguee_nom": null,
  "certification_commune": 1,
  "commune_deleguee_insee": null,
  "lieudit_complement_nom": null
}

Live sample captured at profiling time — values may have changed upstream.

Using the API

Configuration

Base URL: https://data.toulouse-metropole.fr/api/explore/v2.1/catalog/datasets/base-adresse-locale

License

Licence Ouverte 2.0 (France / Etalab)Open

✓ Redistributable
✓ Attribution required

Query examples

curl -s 'https://data.toulouse-metropole.fr/api/explore/v2.1/catalog/datasets/base-adresse-locale/records?limit=20' -H 'Accept: application/json'

First 20 records of the dataset as JSON.

Uses the Opendatasoft Explore v2.1 syntax — supports select, where, group_by and order_by.

Full API documentation ↗

Rate limits

20 000 req/day

per ipmeasured

observed 2 hours ago

Dataset

Volume & freshness

Records

164k

164327

Update cadence

Monthly

declared upstream

Last upstream update

6 days ago

2026-07-18

License

No license declared upstream.

○ Documentation○ Data dictionary○ Versioning

Source: opendatasoft

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.

Base Adresse Locale

Trust score

Data schema (23 fields)

Query the data

Sample data (5 records)

Using the API

Configuration

License

Query examples

Rate limits

Dataset

Volume & freshness

License

Machine-readable & source