National Address Database (BAN)Base Adresse Nationale (BAN)

Base Adresse Nationale (BAN)National Address Database (BAN)

APIJoinable5/7Query nowOpen workbench Subscribe🇫🇷France

The National Address Database (Base Adresse Nationale) is one of the nine reference databases of the French public data service and the only address database officially recognized by the administration. It is overseen by the Interministerial Digital Directorate (DINUM). This local instance is published by Métropole Aix-Marseille-Provence and provides authoritative address data covering its territory, including street names, numbering and geolocation, for use in mapping, address verification and public and private sector applications.La Base Adresse Nationale est l’une des neuf bases de données du service public des données de référence. Elle est la seule base de données d’adresses officiellement reconnue par l’administration. Son pilotage est assuré par la Direction Interministérielle du Numérique (DINUM), qui est chargée d’...

⬇ Export CSV List records Select & filter Run verified request Read the docs

Trust score

How is this computed?

fair

Weighted across five axes. Tap a ring for what it measures.

Data schema (30 fields)

Filterable via the API (28)

objectidid_fantoirnumeronom_voienom_commcodepostalxylonlatrepinsee_oldnom_oldtype_posaliasnom_ldachminmntnom_afnorsrce_possrce_voiecertifcommcad_parcelidnom_donneecodeinseecodecommdatemajsource

Click a field to see example values.

Field	Type	Description
objectid	int	Internal record identifier.Internal record identifier.
id_fantoirId fantoir	text	FANTOIR identifier of the street.FANTOIR identifier of the street.
numeroNuméro de voie	text	House number on the street.House number on the street.
nom_voieNom de voie	text	Name of the street.Name of the street.
nom_commNom de la commune	text	Name of the municipality.Name of the municipality.
codepostal	text	Postal code of the address.Postal code of the address.
xCoordonnées X	text	X coordinate of the address location in the national projection.X coordinate of the address location in the national projection.
yCoordonnées Y	text	Y coordinate of the address location in the national projection.Y coordinate of the address location in the national projection.
lonLongitude	text	Longitude of the address location.Longitude of the address location.
latLatitude	text	Latitude of the address location.Latitude of the address location.
rep	text	Repetition index for the house number (e.g. bis, ter).Repetition index for the house number (e.g. bis, ter).
insee_oldCode INSEE de l'ancienne commune	text	INSEE code of the former municipality, if merged.INSEE code of the former municipality, if merged.
nom_oldNom de l'ancienne commune	text	Name of the former municipality, if merged.Name of the former municipality, if merged.
type_posType de la position	text	Type of the geolocated position (e.g. entrance).Type of the geolocated position (e.g. entrance).
alias	text	Alternate name of the street or locality.Alternate name of the street or locality.
nom_ldNom de l'ID	text	Name of the locality or place (lieu-dit).Name of the locality or place (lieu-dit).
achminmntLibellé d'acheminement	text	Delivery routing label used for mail.Delivery routing label used for mail.
nom_afnorNom sous la norme AFNOR	text	Street name normalized according to AFNOR standard.Street name normalized according to AFNOR standard.
srce_posSource de la position	text	Source of the geolocated position data.Source of the geolocated position data.
srce_voieSource du nom de voie	text	Source of the street name data.Source of the street name data.
certifcommCertification de la commune	text	Certification status of the municipality's address data.Certification status of the municipality's address data.
cad_parcelCadastre parcellaire	text	Cadastral parcel reference linked to the address.Cadastral parcel reference linked to the address.
idIdentifiant	text	Unique identifier of the address record.Unique identifier of the address record.
nom_donneeNom de la Donnée	text	Name of the dataset the record belongs to.Name of the dataset the record belongs to.
codeinseeCode Commune INSEE	text	INSEE code of the municipality.INSEE code of the municipality.
codecommCode Commune DGFIP	text	DGFIP code of the municipality.DGFIP code of the municipality.
datemajDate de mise à jour de la donnée	datetime	Date the address record was last updated.Date the address record was last updated.
sourceSource de production	text	Organization or agency that produced the data.Organization or agency that produced the data.
geo_shapeShape	geo_shape	Geographic shape of the address location as GeoJSON.Geographic shape of the address location as GeoJSON.
geo_point_2dCoordinates	geo_point_2d	Geographic point coordinates of the address.Geographic point coordinates of the address.

Schema captured from opendatasoft 2 days 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: 911118.4632925 · y: 6258080.02957267

{
  "x": "911118.4632925",
  "y": "6258080.02957267",
  "id": "13016_0257_00001",
  "lat": "43.390503",
  "lon": "5.604815",
  "rep": null,
  "alias": null,
  "nom_ld": null,
  "numero": "1",
  "source": "DINUM / ANCT / IGN",
  "datemaj": "2026-10-18T02:00:00+00:00",
  "nom_old": null,
  "codecomm": "131016",
  "nom_comm": "La Bouilladisse",
  "nom_voie": "Chemin des Roquettes",
  "objectid": 362442,
  "srce_pos": "commune",
  "type_pos": "entrée",
  "achminmnt": "LA BOUILLADISSE",
  "codeinsee": "13016",
  "geo_shape": {
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [
        5.604815000103582,
        43.39050299930168
      ]
    },
    "properties": {}
  },
  "insee_old": null,
  "nom_afnor": "CHEMIN DES ROQUETTES",
  "srce_voie": "commune",
  "cad_parcel": "13016000BD0223|13016000BD0025",
  "certifcomm": "1",
  "codepostal": "13720",
  "id_fantoir": "13016_0257",
  "nom_donnee": "Base Adresse Nationale",
  "geo_point_2d": {
    "lat": 43.39050299930168,
    "lon": 5.604815000103582
  }
}

Record 2x: 894983.55048495 · y: 6246978.61884116

{
  "x": "894983.55048495",
  "y": "6246978.61884116",
  "id": "13205_5474_00011",
  "lat": "43.295286",
  "lon": "5.401703",
  "rep": null,
  "alias": null,
  "nom_ld": "saint pierre",
  "numero": "11",
  "source": "DINUM / ANCT / IGN",
  "datemaj": "2026-10-18T02:00:00+00:00",
  "nom_old": null,
  "codecomm": "131205",
  "nom_comm": "Marseille 5e Arrondissement",
  "nom_voie": "Rue lieutenant j b meschi",
  "objectid": 79667,
  "srce_pos": "commune",
  "type_pos": "entrée",
  "achminmnt": "MARSEILLE",
  "codeinsee": "13205",
  "geo_shape": {
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [
        5.401703000169833,
        43.29528599868411
      ]
    },
    "properties": {}
  },
  "insee_old": null,
  "nom_afnor": "RUE LIEUTENANT J B MESCHI",
  "srce_voie": "commune",
  "cad_parcel": "131205822 A0019",
  "certifcomm": "0",
  "codepostal": "13005",
  "id_fantoir": "13205_5474",
  "nom_donnee": "Base Adresse Nationale",
  "geo_point_2d": {
    "lat": 43.29528599868411,
    "lon": 5.401703000169833
  }
}

Record 3x: 845776.40026441 · y: 6256802.39053469

{
  "x": "845776.40026441",
  "y": "6256802.39053469",
  "id": "13078_0465_00006",
  "lat": "43.395402",
  "lon": "4.798596",
  "rep": null,
  "alias": null,
  "nom_ld": null,
  "numero": "6",
  "source": "DINUM / ANCT / IGN",
  "datemaj": "2026-10-18T02:00:00+00:00",
  "nom_old": null,
  "codecomm": "132078",
  "nom_comm": "Port-Saint-Louis-du-Rhône",
  "nom_voie": "Rue Henri de Gibon",
  "objectid": 200872,
  "srce_pos": "commune",
  "type_pos": "entrée",
  "achminmnt": "PORT ST LOUIS DU R",
  "codeinsee": "13078",
  "geo_shape": {
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [
        4.798596000429211,
        43.39540199873888
      ]
    },
    "properties": {}
  },
  "insee_old": null,
  "nom_afnor": "RUE HENRI DE GIBON",
  "srce_voie": "commune",
  "cad_parcel": null,
  "certifcomm": "0",
  "codepostal": "13230",
  "id_fantoir": "13078_0465",
  "nom_donnee": "Base Adresse Nationale",
  "geo_point_2d": {
    "lat": 43.39540199873888,
    "lon": 4.798596000429211
  }
}

Record 4x: 875114.95010992 · y: 6256835.30194222

{
  "x": "875114.95010992",
  "y": "6256835.30194222",
  "id": "13026_0093_00009",
  "lat": "43.389082",
  "lon": "5.160422",
  "rep": null,
  "alias": null,
  "nom_ld": null,
  "numero": "9",
  "source": "DINUM / ANCT / IGN",
  "datemaj": "2026-10-18T02:00:00+00:00",
  "nom_old": null,
  "codecomm": "132026",
  "nom_comm": "Châteauneuf-les-Martigues",
  "nom_voie": "Rue des Bleuets",
  "objectid": 339474,
  "srce_pos": "commune",
  "type_pos": "entrée",
  "achminmnt": "CHATEAUNEUF LES MA",
  "codeinsee": "13026",
  "geo_shape": {
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [
        5.160421999863387,
        43.38908199868091
      ]
    },
    "properties": {}
  },
  "insee_old": null,
  "nom_afnor": "RUE DES BLEUETS",
  "srce_voie": "commune",
  "cad_parcel": "13026000AI0338",
  "certifcomm": "1",
  "codepostal": "13220",
  "id_fantoir": "13026_0093",
  "nom_donnee": "Base Adresse Nationale",
  "geo_point_2d": {
    "lat": 43.38908199868091,
    "lon": 5.160421999863387
  }
}

Record 5x: 861361.09206938 · y: 6269225.26928147

{
  "x": "861361.09206938",
  "y": "6269225.26928147",
  "id": "13047_0137_00004",
  "lat": "43.503767",
  "lon": "4.994674",
  "rep": null,
  "alias": null,
  "nom_ld": null,
  "numero": "4",
  "source": "DINUM / ANCT / IGN",
  "datemaj": "2026-10-18T02:00:00+00:00",
  "nom_old": null,
  "codecomm": "132047",
  "nom_comm": "Istres",
  "nom_voie": "Avenue des Bolles",
  "objectid": 291325,
  "srce_pos": "commune",
  "type_pos": "segment",
  "achminmnt": "ISTRES",
  "codeinsee": "13047",
  "geo_shape": {
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [
        4.994674000384195,
        43.50376699921764
      ]
    },
    "properties": {}
  },
  "insee_old": null,
  "nom_afnor": "AVENUE DES BOLLES",
  "srce_voie": "commune",
  "cad_parcel": null,
  "certifcomm": "0",
  "codepostal": "13800",
  "id_fantoir": "13047_0137",
  "nom_donnee": "Base Adresse Nationale",
  "geo_point_2d": {
    "lat": 43.50376699921764,
    "lon": 4.994674000384195
  }
}

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

Verification Status

Using the API

Configuration

Base URL: https://data.ampmetropole.fr/api/explore/v2.1/catalog/datasets/base-adresse-nationale-ban

License

Terms stated by the source (not a recognized license):

Se conformer aux recommandations du producteur

Query examples

curl -s 'https://data.ampmetropole.fr/api/explore/v2.1/catalog/datasets/base-adresse-nationale-ban/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

5 000 req/day

per ipmeasured

observed 2 days ago

Dataset

Volume & freshness

Records

399k

399024

Last upstream update

3 days ago

2026-10-20

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.