# Rechercher un bâtiment

{% hint style="info" %}
Tous nos points d'accès acceptent un paramètre optionnel supplémentaire `from` qui vous permet de renseigner une adresse mail. Celle-ci nous permettra de vous prévenir en cas de changement sur l'un des endpoints qui vous utilisez.

Par exemple : <https://rnb-api.beta.gouv.fr/api/alpha/buildings/?from=xxx@exemple.fr>
{% endhint %}

{% hint style="info" %}
Rechercher un bâtiment peut faire partie d'un contexte plus large de **rapprochement** entre votre base et le RNB. Si c'est le cas, un [article dédié](/documentation/guides/faire-et-refaire-un-rapprochement-avec-le-rnb.md) discute du sujet.
{% endhint %}

## Bâtiments les plus proches d'un point

> Cet endpoint permet d'obtenir une liste paginée des bâtiments présents dans un rayon donné autour d'un point donné. Les bâtiments sont triés par distance croissante par rapport au point donné. NB : l'URL se termine nécessairement par un slash (/).

```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/closest/":{"get":{"summary":"Bâtiments les plus proches d'un point","description":"Cet endpoint permet d'obtenir une liste paginée des bâtiments présents dans un rayon donné autour d'un point donné. Les bâtiments sont triés par distance croissante par rapport au point donné. NB : l'URL se termine nécessairement par un slash (/).","operationId":"closestBuildings","parameters":[{"name":"point","in":"query","description":"Latitude et longitude, séparées par une virgule, du point de recherche.","required":true,"schema":{"type":"string"}},{"name":"radius","in":"query","description":"Rayon de recherche en mètres, autour du point. Compris entre 0 et 1000 mètres.","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"Liste paginée des bâtiments les plus proches du point donné","content":{"application/json":{"schema":{"type":"object","properties":{"next":{"type":"string","description":"URL de la page de résultats suivante","nullable":true},"previous":{"type":"string","description":"URL de la page de résultats précédente","nullable":true},"results":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Building"},{"type":"object","properties":{"distance":{"type":"number","format":"float","description":"Distance en mètres entre le bâtiment et le point donné"}}}]}}}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"429":{"description":"Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."}}}}},"components":{"schemas":{"Building":{"type":"object","properties":{"rnb_id":{"$ref":"#/components/schemas/RNBID"},"status":{"$ref":"#/components/schemas/BuildingStatus"},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"$ref":"#/components/schemas/BuildingShape"},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"$ref":"#/components/schemas/BuildingAddress"}},"marked_as_correct_by":{"type":"array","description":"Liste des utilisateurs ayant marqué ce bâtiment comme correct. Un bâtiment marqué comme correct par un utilisateur est un bâtiment que cet utilisateur considère comme correspondant à la définition d'un bâtiment et dont il pense que les attributs statut, géométrie et adresses sont corrects.","items":{"$ref":"#/components/schemas/PublicUser"}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":"string","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}},"PublicUser":{"type":"object","properties":{"id":{"type":"integer"},"username":{"type":"string"},"display_name":{"type":"string","description":"Nom à afficher pour l'utilisateur. Il peut s'agir du nom d'utilisateur ou d'un nom plus complet si celui-ci a été renseigné par l'utilisateur."}}},"ExtId":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."}}}}
```

## Identification de bâtiments par leur adresse

> Cet endpoint permet d'obtenir une liste paginée des bâtiments associés à une adresse. NB : l'URL se termine nécessairement par un slash (/).

```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/address/":{"get":{"summary":"Identification de bâtiments par leur adresse","description":"Cet endpoint permet d'obtenir une liste paginée des bâtiments associés à une adresse. NB : l'URL se termine nécessairement par un slash (/).","operationId":"address","parameters":[{"name":"q","in":"query","description":"Adresse texte non structurée. L'adresse fournie est recherchée dans la BAN afin de récupérer la clé d'interopérabilité associée. C'est via cette clé que sont filtrés les bâtiments. Si le geocodage échoue aucun résultat n'est renvoyé et le champ **status** de la réponse contient **geocoding_no_result**","required":false,"schema":{"type":"string"}},{"name":"min_score","in":"query","description":"Score minimal attendu du géocodage BAN. Valeur par défaut : **0.8**. Si le score est strictement inférieur à cette limite, aucun résultat n'est renvoyé et le champ **status** de la réponse contient **geocoding_score_is_too_low**","required":false,"schema":{"type":"number"}},{"name":"cle_interop_ban","in":"query","description":"Clé d'interopérabilité BAN. Si vous êtes en possession d'une clé d'interoperabilité, il est plus efficace de faire une recherche grâce à elle que via une adresse textuelle.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liste paginée des bâtiments associés à l'adresse donnée.","content":{"application/json":{"schema":{"type":"object","properties":{"next":{"type":"string","description":"URL de la page de résultats suivante","nullable":true},"previous":{"type":"string","description":"URL de la page de résultats précédente","nullable":true},"cle_interop_ban":{"type":"string","description":"Clé d'interopérabilité BAN utilisée pour lister les bâtiments","nullable":true},"status":{"type":"string","description":"'geocoding_score_is_too_low' si le géocodage BAN renvoie un score inférieur à 'min_score'. 'geocoding_no_result' si le géocodage ne renvoie pas de résultats. 'ok' sinon","nullable":false},"score_ban":{"type":"number","description":"Si un géocodage a lieu, renvoie le score du meilleur résultat, celui utilisé pour lister les bâtiments. Ce score doit être supérieur à 'min_score' pour que des bâtiments soient renvoyés.","nullable":false},"results":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/Building"}}}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"429":{"description":"Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."}}}}},"components":{"schemas":{"Building":{"type":"object","properties":{"rnb_id":{"$ref":"#/components/schemas/RNBID"},"status":{"$ref":"#/components/schemas/BuildingStatus"},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"$ref":"#/components/schemas/BuildingShape"},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"$ref":"#/components/schemas/BuildingAddress"}},"marked_as_correct_by":{"type":"array","description":"Liste des utilisateurs ayant marqué ce bâtiment comme correct. Un bâtiment marqué comme correct par un utilisateur est un bâtiment que cet utilisateur considère comme correspondant à la définition d'un bâtiment et dont il pense que les attributs statut, géométrie et adresses sont corrects.","items":{"$ref":"#/components/schemas/PublicUser"}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":"string","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}},"PublicUser":{"type":"object","properties":{"id":{"type":"integer"},"username":{"type":"string"},"display_name":{"type":"string","description":"Nom à afficher pour l'utilisateur. Il peut s'agir du nom d'utilisateur ou d'un nom plus complet si celui-ci a été renseigné par l'utilisateur."}}},"ExtId":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."}}}}
```

## Bâtiments sur une parcelle cadastrale

> Cet endpoint permet d'obtenir une liste paginée des bâtiments présents sur une parcelle cadastrale. Les bâtiments sont triés par taux de recouvrement décroissant entre le bâtiment et la parcelle (le bâtiment entièrement sur une parcelle arrive avant celui à moitié sur la parcelle). La méthode de filtrage est purement géométrique et ne tient pas compte du lien fiscal entre le bâtiment et la parcelle. Des faux positifs sont donc possibles. NB : l'URL se termine nécessairement par un slash (/).

```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/plot/{plot_id}/":{"get":{"summary":"Bâtiments sur une parcelle cadastrale","description":"Cet endpoint permet d'obtenir une liste paginée des bâtiments présents sur une parcelle cadastrale. Les bâtiments sont triés par taux de recouvrement décroissant entre le bâtiment et la parcelle (le bâtiment entièrement sur une parcelle arrive avant celui à moitié sur la parcelle). La méthode de filtrage est purement géométrique et ne tient pas compte du lien fiscal entre le bâtiment et la parcelle. Des faux positifs sont donc possibles. NB : l'URL se termine nécessairement par un slash (/).","operationId":"plotBuildings","parameters":[{"name":"plot_id","in":"path","description":"Identifiant de la parcelle cadastrale.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liste paginée des bâtiments présents sur la parcelle cadastrale","content":{"application/json":{"schema":{"type":"object","properties":{"next":{"type":"string","description":"URL de la page de résultats suivante","nullable":true},"previous":{"type":"string","description":"URL de la page de résultats précédente","nullable":true},"results":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Building"},{"type":"number","name":"bdg_cover_ratio","description":"Taux d'intersection entre le bâtiment et la parcelle. Ce taux est compris entre 0 et 1. Un taux de 1 signifie que la parcelle couvre entièrement le bâtiment."}]}}}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"429":{"description":"Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."}}}}},"components":{"schemas":{"Building":{"type":"object","properties":{"rnb_id":{"$ref":"#/components/schemas/RNBID"},"status":{"$ref":"#/components/schemas/BuildingStatus"},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"$ref":"#/components/schemas/BuildingShape"},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"$ref":"#/components/schemas/BuildingAddress"}},"marked_as_correct_by":{"type":"array","description":"Liste des utilisateurs ayant marqué ce bâtiment comme correct. Un bâtiment marqué comme correct par un utilisateur est un bâtiment que cet utilisateur considère comme correspondant à la définition d'un bâtiment et dont il pense que les attributs statut, géométrie et adresses sont corrects.","items":{"$ref":"#/components/schemas/PublicUser"}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":"string","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}},"PublicUser":{"type":"object","properties":{"id":{"type":"integer"},"username":{"type":"string"},"display_name":{"type":"string","description":"Nom à afficher pour l'utilisateur. Il peut s'agir du nom d'utilisateur ou d'un nom plus complet si celui-ci a été renseigné par l'utilisateur."}}},"ExtId":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."}}}}
```

####


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/rechercher-un-batiment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.