Suivi

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

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

curl -sS "https://partner.urbanora.fr/v1/changements?depuis=1041" -H "X-Api-Key: $URBANORA_API_KEY"

{
  "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. Relisez-la :

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.

Démarrer

Guides

Référence API

Suivre

Lire les changements