> ## 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) |
| `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](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. Lire `copropriete.syndic.siren`.
2. Parc du syndic : `GET /v1/syndics/{siren}/portfolio`.
3. Avancement fibre : `GET /v1/imb/{code}/deployment`.
4. Joindre un dirigeant : [Contacts](https://docs.urbanora.fr/guides/contacts.md).

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.