---
id: "fr_ban_cle_interop"
kind: "datatype"
status: "draft"
is_pii: false
name: "French BAN address interoperability key (clé d'interopérabilité)"
regexp: "^(?:\\d{5}|2[ab]\\d{3})_[0-9a-z]{4}(?:_\\d{5}(?:_[0-9a-z]+)?)?$"
categories: ["geo", "government"]
country: ["FR"]
langs: ["common"]
quality: 90
url: "https://registry.apicrafter.io/datatype/fr_ban_cle_interop"
---

# French BAN address interoperability key (clé d'interopérabilité) (`fr_ban_cle_interop`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Key of an address of the Base Adresse Nationale (BAN) and of the local address bases (Base Adresse Locale, BAL) of French municipalities: the INSEE code of the commune, the FANTOIR code of the street (fr_rivoli, four characters without the check letter) and the house number in five digits, joined by underscores, with the suffix of a number (bis, ter, a) at the end, all in lowercase: 67482_3379_00019 is number 19 of a street of Strasbourg, 67519_0940_00015_bis would be 15 bis. A key of the street alone has two parts (67482_0241). The BAL format calls it cle_interop.

- Parent datatype: [`id`](https://registry.apicrafter.io/datatype/id.md)
- Personal data (PII): no
- Categories: Geographic identifiers (geo), Government related (government)
- Countries: France (FR)
- Languages: Common to most languages (common)
- Classification: identifier

## Detection

Regular expression (Python `re`):

```
^(?:\d{5}|2[ab]\d{3})_[0-9a-z]{4}(?:_\d{5}(?:_[0-9a-z]+)?)?$
```

## Examples

- `67519_0940_00015` — an address of the Base Adresse Locale of the Eurométropole de Strasbourg
- `67482_3379_00019` — an address of Strasbourg, digital mediation places
- `67482_0241` — a street of Strasbourg without a number
- `67482_3086F_00019` (invalid example) — RIVOLI code with its check letter
- `67482-3379-00019` (invalid example) — hyphens instead of underscores

## Metacrafter rules

2 rules: 1 match the field name, 1 match values.

- `frbancleinteropbyname` (field, `fr/fr_geo.yaml`)
- `frbancleinteropvalue` (data, `fr/fr_geo.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- fr: Clé d'interopérabilité d'une adresse (BAN, BAL)
- ru: Ключ интероперабельности адреса BAN (Франция)

## Sources

- doc: <https://doc.adresse.data.gouv.fr/>
- wikipedia: <https://fr.wikipedia.org/wiki/Base_adresse_nationale>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/fr_ban_cle_interop.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/FR/geo/fr_ban_cle_interop.yaml>
