> For the complete documentation index, see [llms.txt](https://rnb-fr.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments.md).

# API Bâtiments

{% hint style="warning" icon="octagon" %}
**Limites d'utilisation**\
Les API du RNB sont limitées à 20 requêtes par adresse IP et par seconde.\
Les tuiles vectorielles ne sont pas concernées par cette limite.
{% endhint %}

{% 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 %}

{% content-ref url="/pages/Sc9UocNnqYiVLjnJrHvQ" %}
[Consulter un bâtiment](/documentation/api-et-outils/api-batiments/consulter-un-batiment.md)
{% endcontent-ref %}

Consulter les informations d'un bâtiment précis à partir de son identifiant RNB (ID-RNB). Ceci, vous permettra de récupérer l'ensemble de ses informations.

***

{% content-ref url="/pages/WsQ6lv1zvbYZ5A4H2Zec" %}
[Lister des bâtiments](/documentation/api-et-outils/api-batiments/lister-des-batiments.md)
{% endcontent-ref %}

Obtenir une liste paginée de bâtiments. Des filtres de recherche (ex: code INSEE de la ville) sont à disposition.

***

{% content-ref url="/pages/BIlUA26zZYXQJlrjkslH" %}
[Rechercher un bâtiment](/documentation/api-et-outils/api-batiments/rechercher-un-batiment.md)
{% endcontent-ref %}

Récupérer l'identifiant RNB (ID-RNB) d'un bâtiment à partir d'inputs variés (localisation, adresse, parcelle cadastrale, etc)

***

{% content-ref url="/pages/5Gl1LEjNmn6uYwPNE2R7" %}
[Différentiel entre deux dates](/documentation/api-et-outils/api-batiments/differentiel-entre-deux-dates.md)
{% endcontent-ref %}

Obtenez toutes les modifications du RNB depuis une date donnée.

***

{% content-ref url="/pages/9WZfLYxVESAnUQyXQpbA" %}
[Éditer le RNB](/documentation/api-et-outils/api-batiments/editer-le-rnb.md)
{% endcontent-ref %}

Contribuer au RNB en éditant son contenu : création et mise à jour de bâtiments, désactivation d'un ID-RNB, etc.
