# 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.


---

# 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.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.