# Lister des bâtiments {% 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](/documentation/api-et-outils/api-batiments/standard-ogc-api-features.md) {% endhint %} ## Liste des batiments > Cet endpoint permet de récupérer une liste paginée de bâtiments. Des filtres, notamment par code INSEE de la commune, sont disponibles.Au moins un filtre est requis.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/":{"get":{"summary":"Liste des batiments","description":"Cet endpoint permet de récupérer une liste paginée de bâtiments. Des filtres, notamment par code INSEE de la commune, sont disponibles.Au moins un filtre est requis.NB : l'URL se termine nécessairement par un slash (/).","operationId":"listBuildings","parameters":[{"name":"insee_code","in":"query","description":"Filtre les bâtiments dont l'emprise au sol est située dans les limites géographiques de la commune ayant ce code INSEE.","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filtre les bâtiments par statut. Il est possible d'utiliser plusieurs valeurs séparées par des virgules. Les valeurs possibles sont :


","required":false,"schema":{"type":"string"}},{"name":"cle_interop_ban","in":"query","description":"Filtre les bâtiments associés à cette clé d'interopérabilité BAN.","required":false,"schema":{"type":"string"}},{"name":"withPlots","in":"query","description":"Inclure les parcelles intersectant les bâtiments de la réponse. 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.","required":false,"schema":{"type":"integer","default":0,"enum":[0,1]}},{"name":"format","in":"query","description":"Format de la réponse. Valeurs possibles : `json` (par défaut) ou `geojson`. En format `geojson`, l'attribut `results` de la réponse est un objet de type FeatureCollection tel que défini dans le standard GeoJSON.","required":false,"schema":{"type":"string","default":"json","enum":["json","geojson"]}},{"name":"limit","in":"query","description":"Nombre maximum de bâtiments à retourner dans la page de résultats. Valeur par défaut : 20. Valeur maximale : 100.","required":false,"schema":{"type":"integer","default":20,"maximum":100,"minimum":1}},{"name":"bbox","in":"query","description":"Filtre les bâtiments dont l'emprise au sol est située dans la bounding box.Le format est `min_lon,min_lat,max_lon,max_lat`La taille de la bbox est limitée par la contrainte (max_lon - min_lon) * (max_lat - min_lat) < 4. Cela correspond à la surface d'environ deux départements français.","required":false,"schema":{"type":"string"}},{"name":"bb","in":"query","description":"OBSOLÈTE - préférez le paramètre `bbox` Filtre les bâtiments dont l'emprise au sol est située dans la bounding box définie par les coordonnées Nord-Ouest et Sud-Est. Les coordonnées sont séparées par des virgules. Le format est `nw_lat,nw_lon,se_lat,se_lon`La taille de la bbox est limitée par la contrainte (se_lon - nw_lon) * (nw_lat - se_lat) < 4. Cela correspond à la surface d'environ deux départements français.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liste paginée de bâtiments","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"},{"$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"}},"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."},"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."}}}}}}} ``` --- # 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/lister-des-batiments.md?ask= ``` 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.