Skip to main content

BAN French Address File

The Base Adresse Nationale (BAN) is France's official open national address database, covering metropolitan France and the overseas départements down to the house-number level.

Essential Elements​

Address​

addressstring

The house number of the address.

Can be empty string "" if not present.

Example
8

Address Line One​

line_1string

First address line (house number, suffix, and street name).

Can be null if not present.

Example
8 bis avenue des Champs-Élysées

Address Line Two​

line_2string

Second address line (postcode and municipality name).

Can be null if not present.

Example
75008 Paris

Geographic and Location Information​

Country​

countrystring

Full country names (ISO 3166)

Values
  • "France"

Country ISO​

country_iso

3 letter country code (ISO 3166-1)

Values
  • "FRA"

Country ISO 2​

country_iso_2string

2 letter country code (ISO 3166-1)

Values
  • "FR"

Language​

language

Language represented by 2 letter ISO Code (639-1)

Values
  • "fr"

Longitude​

longitude

Latitude​

latitude

Source Longitude (lon)​

lonstring

Longitude (WGS84) as returned from source data

Source Latitude (lat)​

latstring

Latitude (WGS84) as returned from source data

Easting (Lambert 93)​

xstring

Lambert 93 easting coordinate

Northing (Lambert 93)​

ystring

Lambert 93 northing coordinate

Position Type​

type_positionstring

Positional accuracy type (entrée, bâtiment, parcelle, délivrance postale, etc.)

Position Source​

source_positionstring

Source of position data (commune, IGN, etc.)

Address Components and Identifiers​

ID​

id

Dataset​

datasetstring
Values
  • "ban"

FANTOIR Street Identifier​

id_fantoirstring

FANTOIR street identifier

House Number​

numerointeger

House number

House Number Suffix​

repstring

House number suffix / répétition (bis, ter, quater, etc.)

Street Name​

nom_voiestring

Street name

AFNOR Street Name​

nom_afnorstring

AFNOR-normalised street name

Street Name Source​

source_nom_voiestring

Source of street name data

Alias​

aliasstring

Address alias

Lieu-dit​

nom_ldstring

Lieu-dit (named place) label

Municipality and Postal Information​

Postal Code​

code_postalstring

5-digit postal code

INSEE Commune Code​

code_inseestring

INSEE commune code (2-digit département + 3-digit commune)

Municipality Name​

nom_communestring

Municipality name

Former Commune INSEE Code​

code_insee_ancienne_communestring

INSEE code of the pre-fusion commune (for merged municipalities)

Former Commune Name​

nom_ancienne_communestring

Name of the pre-fusion commune (for merged municipalities)

Postal Routing Label​

libelle_acheminementstring

Postal routing label

Municipality Certification​

certification_communeboolean

Whether the municipality has certified this address

Cadastral Parcels​

cad_parcellesstring

Cadastral parcel reference(s)