# Différentiel entre deux dates

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

## Différences depuis une date donnée

> Liste l'ensemble des modifications apportées au RNB depuis une date données. Génère un fichier CSV. Voici les points importants à retenir : \<br />\<ul>\<li>La colonne action correspond à l'action à mener sur une base local pour la garder synchronisée avec le RNB. Il existe 3 types d'actions : create, update et delete\</li>\<li>Les modifications sont triées par date de modification croissante\</li>\<li>Il est possible qu'un même bâtiment ait plusieurs modifications dans la période considérée. Par exemple, une création (create) suivie d'une mise à jour (update)\</li>\<li>La colonne \`event\_type\` correspond à l'opération réalisée sur le bâtiment (création, désactivation, mise à jour, fusion, scission)\</li>\</ul>Par exemple, une fusion de deux bâtiments fera apparaître 3 lignes qui partageront la même action (merge) et le même \`event\_id\`. Les deux bâtiments parents auront l'action \`delete\` tandis que le bâtiment enfant aura l'action \`create\`.Voici un exemple de requête permettant d'obtenir les modifications du RNB ayant eu lieu depuis une date déterminée : \`<https://rnb-api.beta.gouv.fr/api/alpha/buildings/diff/?since=2026-06-10> 14:57:57.422564+00:00\`

```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/diff/":{"get":{"summary":"Différences depuis une date donnée","description":"Liste l'ensemble des modifications apportées au RNB depuis une date données. Génère un fichier CSV. Voici les points importants à retenir : <br /><ul><li>La colonne action correspond à l'action à mener sur une base local pour la garder synchronisée avec le RNB. Il existe 3 types d'actions : create, update et delete</li><li>Les modifications sont triées par date de modification croissante</li><li>Il est possible qu'un même bâtiment ait plusieurs modifications dans la période considérée. Par exemple, une création (create) suivie d'une mise à jour (update)</li><li>La colonne `event_type` correspond à l'opération réalisée sur le bâtiment (création, désactivation, mise à jour, fusion, scission)</li></ul>Par exemple, une fusion de deux bâtiments fera apparaître 3 lignes qui partageront la même action (merge) et le même `event_id`. Les deux bâtiments parents auront l'action `delete` tandis que le bâtiment enfant aura l'action `create`.Voici un exemple de requête permettant d'obtenir les modifications du RNB ayant eu lieu depuis une date déterminée : `https://rnb-api.beta.gouv.fr/api/alpha/buildings/diff/?since=2026-06-10 14:57:57.422564+00:00`","operationId":"getDiff","parameters":[{"name":"since","in":"query","description":"Date et heure à partir de laquelle les modifications sont retournées. Le format est ISO 8601. <br />La période maximale proposée est de 6 mois.<br/>Pour récupérer le RNB dans son intégralité, téléchargez la base de données (l'ensemble de la base est <a href='https://www.data.gouv.fr/fr/datasets/referentiel-national-des-batiments/'>disponible ici</a>). ","required":true,"schema":{"type":"string"}},{"name":"insee_code","in":"query","description":"Code INSEE de la commune pour filtrer les modifications du RNB. Seules les modifications de bâtiments dont la géométrie intersecte la commune seront retournées. Le code INSEE est composé de 5 caractères.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Fichier CSV listant l'ensemble des opérations ayant modifié le RNB depuis la date indiquée.","content":{"text/csv":{"schema":{"type":"string"}}}},"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."}}}}}}
```

La description des champs est [disponible sur cette page](/documentation/lexique-et-definitions/proprietes-dun-batiment.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/differentiel-entre-deux-dates.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.