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.

Address from France's Base Adresse Nationale (BAN), the official open national address database published via Etalab.

BAN reaches house-number level only (numero + street + commune) - it carries no sub-premise (unit, floor, building) data.

Example Record

Field	Example	Type
id	ban_01002_w4ld4h_00006	string
dataset	ban	string
country	France	string
country_iso	FRA	string
country_iso_2	FR	string
language	fr	string
address	6	string
line_1	6 place du Pese Lait	string
line_2	01640 L'Abergement-de-Varey	string
latitude	46.005447	number
longitude	5.425179	number
id_fantoir	null	object
numero	6	number
rep	null	object
nom_voie	Place du Pese Lait	string
code_postal	01640	string
code_insee	01002	string
nom_commune	L'Abergement-de-Varey	string
code_insee_ancienne_commune	null	object
nom_ancienne_commune	null	object
x	887643.67	string
y	6547960.53	string
lon	5.425179	string
lat	46.005447	string
type_position	entrée	string
alias	null	object
nom_ld	null	object
libelle_acheminement	ABERGEMENT-DE-VAREY (L )	string
nom_afnor	PLACE DU PESE LAIT	string
source_position	commune	string
source_nom_voie	commune	string
certification_commune	true	boolean
cad_parcelles	01002000AE0005	string

Every field is documented below.

Essential Elements

address string

Address

The house number of the address (numero), without any suffix.

Can be empty string "" if not present.

Example 6

line_1 string

Address Line One

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

Can be null if not present.

Example 6 place du Pese Lait

line_2 string

Address Line Two

Second address line (postcode and municipality name).

Can be null if not present.

Example 01640 L'Abergement-de-Varey

Geographic and Location Information

country string

Country

Full country names (ISO 3166)

Example France

Enum

• "France"

country_iso string

Country ISO

3 letter country code (ISO 3166-1)

Example FRA

Enum

• "FRA"

country_iso_2 string

Country ISO 2

2 letter country code (ISO 3166-1)

Example FR

Enum

• "FR"

language string

Language

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

Example fr

Enum

• "fr"

longitude string

Longitude

Example 5.425179

latitude string

Latitude

Example 46.005447

lon string

Source Longitude (lon)

Longitude (WGS84) as returned from source data

Example 5.425179

lat string

Source Latitude (lat)

Latitude (WGS84) as returned from source data

Example 46.005447

x string

Easting (Lambert 93)

Lambert 93 easting coordinate

Example 887643.67

y string

Northing (Lambert 93)

Lambert 93 northing coordinate

Example 6547960.53

type_position string

Position Type

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

Example entrée

source_position string

Position Source

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

Example commune

Address Components and Identifiers

id string

ID

Example ban_01002_w4ld4h_00006

dataset string

Dataset

Example ban

Enum

• "ban"

id_fantoir string

FANTOIR Street Identifier

FANTOIR street identifier

numero integer

House Number

House number

Example 6

rep string

House Number Suffix

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

nom_voie string

Street Name

Street name

Example Place du Pese Lait

nom_afnor string

AFNOR Street Name

AFNOR-normalised street name

Example PLACE DU PESE LAIT

source_nom_voie string

Street Name Source

Source of street name data

Example commune

alias string

Alias

Address alias

nom_ld string

Lieu-dit

Lieu-dit (named place) label

Municipality and Postal Information

code_postal string

Postal Code

5-digit postal code

Example 01640

code_insee string

INSEE Commune Code

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

Example 01002

nom_commune string

Municipality Name

Municipality name

Example L'Abergement-de-Varey

code_insee_ancienne_commune string

Former Commune INSEE Code

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

nom_ancienne_commune string

Former Commune Name

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

libelle_acheminement string

Postal Routing Label

Postal routing label

Example ABERGEMENT-DE-VAREY (L )

certification_commune boolean

Municipality Certification

Whether the municipality has certified this address

Example true

cad_parcelles string

Cadastral Parcels

Cadastral parcel reference(s)

Example 01002000AE0005