# Consulter 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 : {% endhint %} {% hint style="success" %} **API RNB au standard OGC API - Features** En plus du endpoint décrit sur cette page, nous proposons un endpoint respectant le standard OGC API - Features. Il permet d'utiliser plus facilement notre API dans des outils comme QGIS, FME ou ArcGIS. [Consulter](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/standard-ogc-api-features) {% endhint %} ## Consultation d'un bâtiment > Cet endpoint permet de récupérer l'ensemble des attributs d'un bâtiment à partir de son identifiant RNB. 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/{rnb_id}/":{"get":{"summary":"Consultation d'un bâtiment","description":"Cet endpoint permet de récupérer l'ensemble des attributs d'un bâtiment à partir de son identifiant RNB. NB : l'URL se termine nécessairement par un slash (/).","operationId":"getBuilding","parameters":[{"name":"rnb_id","in":"path","description":"Identifiant unique du bâtiment dans le RNB (ID-RNB)","required":true,"schema":{"type":"string"}},{"name":"withPlots","in":"query","description":"Inclure les parcelles intersectant le bâtiment. Valeur attendue : 1. Chaque parcelle associée intersecte le bâtiment correspondant. Elle contient son identifiant ainsi que le taux de couverture du bâtiment par cette parcelle.","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Format de la réponse. Valeurs possibles : `json` (par défaut) ou `geojson`. En format `geojson`, la réponse est un objet de type Feature tel que défini dans le standard GeoJSON.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Détails du bâtiment","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Building"},{"$ref":"#/components/schemas/BuildingWPlots"}]}}}},"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"}},"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"}}},"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."},"BuildingWPlots":{"type":"object","properties":{"plots":{"$ref":"#/components/schemas/BuildingPlots"}}},"BuildingPlots":{"type":"array","description":"Liste des parcelles cadastrales intersectant le bâtiment. Disponible si le paramètre 
withPlots=1
est intégré à l'URL de requête. NB: il s'agit d'un croisement géométrique et non d'une donnée fiscale. Il arrive parfois qu'un bâtiment intersecte une mauvaise parcelle du fait d'un décalage géographique entre les bâtiments du cadastre et ceux du RNB. Nous fournissons avec chaque parcelle cadastrale le taux d'intersection du bâtiment avec celle-ci. Les parcelles intersectant largement un bâtiment sont plus susceptibles d'être réellement associées à ce bâtiment d'un point de vue fiscal.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de la parcelle."},"bdg_cover_ratio":{"type":"number","description":"Taux d'intersection du bâtiment par la parcelle. Ce taux est compris entre 0 et 1. Un taux de 1 signifie que la parcelle couvre entièrement le bâtiment."}}}}}}} ```