> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urbanora.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Suivi

> Suivre des bâtiments et savoir quelles données ont changé, sans webhook.

Vous déclarez des IMB ; nous contrôlons chaque bâtiment une fois par jour, après nos mises à jour de nuit. Quand une donnée change (nouveau syndic, nouveau dirigeant, occupant qui arrive ou part, état fibre…), une ligne entre au journal. Vous lisez le journal quand vous voulez.

## Suivre

```bash theme={null}
curl -sS -X POST https://partner.urbanora.fr/v1/suivis \
  -H "X-Api-Key: $URBANORA_API_KEY" -H "content-type: application/json" \
  -d '{ "imb": ["IMB/13201/C/A01Y", "IMB/13201/C/A01Z"] }'
# → { "ajoutes": 2, "total": 2 }
```

* 1 000 IMB au plus par appel ; 10 000 bâtiments suivis par organisation.
* Le premier contrôle sert de référence et ne produit pas de changement.
* `GET /v1/suivis` liste vos bâtiments suivis et la date du dernier contrôle ; `DELETE /v1/suivis/{imb}` en retire un (`/` encodé `%2F`).

## Lire les changements

```bash theme={null}
curl -sS "https://partner.urbanora.fr/v1/changements?depuis=1041" -H "X-Api-Key: $URBANORA_API_KEY"
```

```json theme={null}
{
  "changements": [
    { "id": "1042", "imb": "IMB/13201/C/A01Y", "donnee": "copropriete", "detecte_le": "2026-11-14T05:12:09.000Z" },
    { "id": "1043", "imb": "IMB/13201/C/A01Z", "donnee": "occupants", "detecte_le": "2026-11-14T05:12:11.000Z" }
  ],
  "curseur": "1043",
  "encore": false
}
```

* Gardez `curseur` et repassez-le dans `depuis` au prochain appel : vous ne lisez que la suite.
* `encore: true` : il reste des lignes, rappelez tout de suite avec le nouveau curseur.
* `donnee` est l'une des onze données de [`GET /v1/batiment`](https://docs.urbanora.fr/guides/batiment). Relisez-la :

```bash theme={null}
curl -sS "https://partner.urbanora.fr/v1/batiment?imb=IMB%2F13201%2FC%2FA01Y&donnees=copropriete" \
  -H "X-Api-Key: $URBANORA_API_KEY"
```

Une lecture de `GET /v1/batiment` sur un bâtiment suivi vaut aussi contrôle : un changement vu à cette occasion entre au journal.

Les contrôles quotidiens ne consomment pas votre quota d'appels. Un rythme d'une lecture du journal par heure suffit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.