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)
`decisionnaires`	Nom, prénom, qualité, SIREN rattaché
`occupants`	Établissements à l’adresse (SIRET, NAF, effectif)
`fraicheur`	Millésimes ARCEP, RNIC, RNE, MAJIC, BDNB

proprietaires (personnes morales uniquement) n’est pas une clé vide : le champ est omis sauf si la clé a le scope owners. 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

Lire copropriete.syndic.siren.
Parc du syndic : GET /v1/syndics/{siren}/portfolio.
Avancement fibre : GET /v1/imb/{code}/deployment.
Joindre un dirigeant : Contacts.

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