> ## 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.

# Qualifier un immeuble

> Un appel, la chaîne complète — fibre, bâtiment, copropriété, syndic, décisionnaires.

`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`.

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

```ts TypeScript theme={null}
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](https://docs.urbanora.fr/api-reference/buildings/qualifier-un-immeuble-fibre-copro-syndic-occupants.md).

## 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

1. Choisir un décisionnaire dans `decisionnaires`.
2. Joindre ce dirigeant : [Contacts](https://docs.urbanora.fr/guides/contacts.md).
3. Parc du syndic : `GET /v1/syndics/{siren}/portfolio`, avec `copropriete.syndic.siren`.
4. Avancement fibre : `GET /v1/imb/{code}/deployment`.

Pour une plaque plutôt qu'un immeuble : [Plaques / zones](https://docs.urbanora.fr/guides/plaques-zones.md).


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