# 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-04-07> 13:26:48.056023+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-04-07 13:26:48.056023+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 />Seules les dates après le 1er avril 2024 sont acceptées.<br/>Une date antérieure reviendrait à télécharger l'intégralité de 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](https://rnb-fr.gitbook.io/documentation/lexique-et-definitions/proprietes-dun-batiment).