Documentation Recherche BAN & Identifiants IMB

Moteur de recherche géospatiale haute performance basé sur la Base Adresse Nationale (BAN) officielle et la table nationale des Immeubles Bâtis (IMB) de l'ARCEP.

Version : 2.4.0 (2026)Couverture : France entière + DROM-COMLatence Moyenne : < 25 ms

1. Spécification & Authentification

L'API de recherche permet de convertir en temps réel toute saisie utilisateur en identifiants pérennes (ban_id et imb_id) nécessaires au calcul d'éligibilité.

2. Autocomplétion d'Adresse Nationale

GET /api/v1/search/autocomplete

Exemple de Requête cURL :

terminal — bash (cURL)

1curl -X GET "https://backend.eligentra.telxora.com/api/v1/search/autocomplete?q=12+Rue+de+la+Paix+Paris&limit=5" \
2     -H "X-API-Key: telecom_live_sk_partner_sample_2026" \
3     -H "Accept: application/json"

Réponse JSON (200 OK) :

response (200 OK) • application/json

1[
2  {
3    "ban_id": "75102_7065_00012",
4    "label": "12 Rue de la Paix 75002 Paris",
5    "city": "Paris",
6    "postcode": "75002",
7    "citycode": "75102",
8    "street": "Rue de la Paix",
9    "housenumber": "12",
10    "context": "75, Paris, Île-de-France",
11    "latitude": 48.8698,
12    "longitude": 2.3312,
13    "imb_id": "IMB/75102/X/0012",
14    "score": 0.96
15  }
16]

3. Résolution Bâtiment par Identifiant IMB

GET /api/v1/search/imb

Permet de cibler directement un immeuble répertorié par l'ARCEP lorsque vous possédez déjà son identifiant (ex : IMB/75102/X/0012).

4. Format JSON & Coordonnées

Chaque résultat comprend des coordonnées précises (WGS84) au format décimal (latitude, longitude) pouvant être directement projetées sur une carte Leaflet ou Google Maps.

5. Adresses Multiples & Erreurs

Adresses Incomplètes : Lorsque plusieurs numéros ou voies correspondent, l'API retourne les suggestions ordonnées par score de pertinence décroissant.

Adresse Inconnue : L'API retourne un tableau vide [] avec un statut HTTP 200 OK.

6. Données & Adresses de Test

Requête :q=12+Rue+de+la+Paix+Paris→ban_id: 75102_7065_00012(Score: 0.96)

Requête :q=14+Boulevard+Saint-Germain+Paris→ban_id: 75105_8545_00014