Qualifier un immeuble

GET /v1/buildings/qualify est l’endpoint qui porte l’offre. Scope buildings.

Entrée — un seul mode

Query	Exemple
`address`	`12 rue de la République, Marseille`
`imb_code`	`IMB/13055/X/0042`
`parcelle_id`	`13055000AB0123`
`lon` + `lat`	`5.3698` / `43.2965` (WGS84)

Deux modes à la fois → 400 BAD_REQUEST. Immeuble introuvable → 404 BUILDING_NOT_FOUND.

curl -sS "https://partner.urbanora.fr/v1/buildings/qualify?imb_code=IMB/13055/X/0042" \
  -H "X-Api-Key: $URBANORA_API_KEY"

const url = new URL("https://partner.urbanora.fr/v1/buildings/qualify");
url.searchParams.set("imb_code", "IMB/13055/X/0042");

const res = await fetch(url, {
  headers: { "X-Api-Key": process.env.URBANORA_API_KEY! },
});
const qualify = await res.json();

Sortie — une seule réponse

Blocs toujours présents (valeurs éventuellement null) :

Bloc	Contenu
`imb`	Code, adresse, locaux, identifiants bâtiment / parcelle
`fibre`	Statut, opérateurs, date raccordable, fermeture cuivre, millésime ARCEP
`batiment`	Année, logements, étages, usage
`copropriete`	Immatriculation, lots, syndic (raison sociale, SIREN, type)
`proprietaires`	Propriétaires personnes morales (cadastre), `probable: true` si déduit des occupants
`gestionnaires`	Régies détectées, avec un niveau de confiance
`decisionnaires`	Dirigeants du syndic, des régies et des propriétaires, dans cet ordre
`occupants`	Établissements à l’adresse (SIRET, NAF, effectif)
`fraicheur`	Millésimes ARCEP, RNIC, RNE, MAJIC, BDNB

Chaque décisionnaire indique pour qui il agit (pour : syndic, regie, proprietaire), la personne morale dirigée (raison_sociale, siren) et sa qualité. Pas de propriétaire personne physique : une personne physique n’apparaît que comme dirigeant. Un dirigeant peut lui-même être une société (personne: "morale") : siren_dirigeant donne son SIREN pour remonter à ses dirigeants. Le schéma exact, avec types et exemples : GET /v1/buildings/qualify.

Facturation de l’unité

Un immeuble qualifié compte une unité / identifiant bâtiment / 30 jours pour l’organisation de la clé. Relancer qualify sur le même bâtiment dans la fenêtre ne recrée pas l’unité. Les montants sont dans votre contrat, pas dans cette doc. Consulter le compteur : GET /v1/meta/usage (scope meta) — buildings_qualified, contacts_delivered, calls.

Suite du parcours

Choisir un décisionnaire dans decisionnaires.
Joindre ce dirigeant : Contacts.
Parc du syndic : GET /v1/syndics/{siren}/portfolio, avec copropriete.syndic.siren.
Avancement fibre : GET /v1/imb/{code}/deployment.

Pour une plaque plutôt qu’un immeuble : Plaques / zones.

⌘I

Démarrer

Guides

Référence API

Qualifier un immeuble

Entrée — un seul mode

Sortie — une seule réponse

Facturation de l’unité

Suite du parcours

​Entrée — un seul mode

​Sortie — une seule réponse

​Facturation de l’unité

​Suite du parcours

Entrée — un seul mode

Sortie — une seule réponse

Facturation de l’unité

Suite du parcours