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

# Bâtiment

> GET /v1/batiment — toutes les données d'un bâtiment, sourcées et datées.

```bash theme={null}
curl -sS "https://partner.urbanora.fr/v1/batiment?adresse=12%20rue%20de%20la%20R%C3%A9publique%2013001%20Marseille" \
  -H "X-Api-Key: $URBANORA_API_KEY"
```

## Point d'entrée

Un seul des trois :

| Paramètre | Exemple | |
| - | - | - |
| `imb` | `IMB/13201/C/A01Y` | Code IMB ARCEP |
| `parcelle` | `132018010E0001` | Parcelle cadastrale (14 caractères) |
| `adresse` | `12 rue de la République 13001 Marseille` | Géocodée sur la Base Adresse Nationale ; l'IMB retenu est le plus proche de l'adresse |

## Réponse

```json theme={null}
{
  "batiment": {
    "imb": "IMB/13201/C/A01Y",
    "imbs": ["IMB/13201/C/A01Y", "IMB/13201/C/A01Z", "…"],
    "parcelle": "132018010E0001",
    "parcelles": ["132018010E0001"],
    "batiments_bdnb": ["bdnb-bg-SDWG-X4WX-ZDHR", "bdnb-bg-3A2W-LXKZ-LXFQ"],
    "adresse": "18 Rue de la république 13001 Marseille 1er Arrondissement",
    "code_postal": "13001",
    "commune": "Marseille 1er Arrondissement",
    "code_insee": "13201",
    "lon": 5.3737,
    "lat": 43.2971
  },
  "donnees": {
    "copropriete": {
      "valeur": { "immatriculation": "AA0000000", "nb_lots": 55, "syndic": { "…": "…" } },
      "sources": [{ "code": "rnic", "producteur": "ANAH", "mise_a_jour": "2026-11-13", "…": "…" }],
      "empreinte": "8785059736d324f1"
    }
  },
  "genere_le": "2026-11-13T17:16:47.310Z"
}
```

* `batiment` revient toujours : les clés pour relier à votre système.
* `donnees` contient une entrée par donnée demandée. Chaque entrée : `valeur`, `sources`, `empreinte`.
* `empreinte` change quand la donnée change. Vous pouvez la stocker et comparer, ou laisser le [suivi](https://docs.urbanora.fr/guides/suivi.md) le faire.

## Choisir les données

`donnees` prend une liste séparée par des virgules. Sans `donnees`, tout revient.

```bash theme={null}
curl -sS "https://partner.urbanora.fr/v1/batiment?imb=IMB%2F13201%2FC%2FA01Y&donnees=copropriete,gestionnaires" \
  -H "X-Api-Key: $URBANORA_API_KEY"
```

| Donnée | Contenu | Sources |
| - | - | - |
| `decisionnaires` | Tous les acteurs juridiques du bâtiment dans l'ordre de prospection, et le décisionnaire. Voir [Acteurs et cascade](https://docs.urbanora.fr/guides/acteurs-cascade.md) | RNIC, fichiers fonciers, SIRENE, RNE |
| `caracteristiques` | Par bâtiment : année, logements, niveaux, hauteur, surface au sol, usage, matériaux, noms du lieu, site complexe, servitudes patrimoine | BDNB, GPU, noms de lieux |
| `fibre` | Statut agrégé ; par IMB : type, locaux, état, point de mutualisation, opérateur d'infrastructure, opérateurs fibre, éligibilité par opérateur et technologie | ARCEP, Cartefibre |
| `copropriete` | Immatriculation, lots, période, mandat ; type et statut du syndic ; syndic : SIREN, SIRET, siège, dirigeants | RNIC, RNE, SIRENE |
| `proprietaires` | Propriétaires au cadastre et propriétaires probables : lots détenus sur la parcelle, taille du parc, confiance et indices, dirigeants | Fichiers fonciers, SIRENE, RNE |
| `gestionnaires` | Régies : confiance, indices, lots, dirigeants | Fichiers fonciers, SIRENE, RNE |
| `occupants` | Établissements actifs, partis ou fermés : SIRET, enseigne, NAF, effectif, siège sur place, exploitant, prestataire, dirigeants | SIRENE, RNE |
| `permis` | Permis de construire : type, état, dates, demandeur, logements et surfaces créés | Sitadel (via BDNB) |
| `stationnement` | Lots de stationnement (copro, BDNB), parkings OpenStreetMap, bornes de recharge | RNIC, BDNB, OSM, IRVE |
| `energie` | DPE représentatif par bâtiment, répartition des étiquettes, DPE logement et tertiaire | ADEME via BDNB |
| `urbanisme` | Zone du PLU, PSMV, servitudes patrimoine | Géoportail de l'urbanisme |

Une donnée absente vaut `null` (pas de copropriété) ou une liste vide (pas d'occupant).

## Entreprises, dirigeants et contacts

Chaque acteur (syndic, régie, propriétaire, occupant) est décrit en détail, avec la logique de la cascade, dans [Acteurs et cascade](https://docs.urbanora.fr/guides/acteurs-cascade.md). Ils partagent cette forme :

```json theme={null}
{
  "siren": "512345678",
  "denomination": "SARL CABINET MARTIN",
  "forme_juridique": null,
  "etat_administratif": "A",
  "adresse_siege": "1 RUE EXEMPLE, 13001 MARSEILLE",
  "dirigeants": [
    {
      "nom": "MARTIN", "prenom": "Claire", "qualite": "Directeur Général",
      "personne": "physique", "siren": null,
      "contact": { "ref": "ct_eyJ0Ijoi…", "canaux": ["email_pro", "linkedin"], "credits": { "email_pro": 1, "linkedin": 1 } }
    },
    { "nom": "HOLDING EXEMPLE", "qualite": "Président de SAS", "personne": "morale", "siren": "498765432", "contact": null }
  ],
  "contact": { "ref": "ct_eyJ0Ijoi…", "canaux": ["standard"], "credits": { "standard": 1 } }
}
```

`contact` dit ce que vous pouvez demander et ce que coûte chaque canal s'il est trouvé (`credits`). Il vaut `null` quand rien n'est possible :

* **Entreprise** : `standard` quand elle a un accueil joignable (enseigne, syndic professionnel, cabinet de santé, exploitant du site). Une SCI ou un syndicat de copropriétaires n'en a pas.
* **Dirigeant personne physique** : `email_pro` et `linkedin` ; `email_perso` et `mobile` si votre contrat les inclut.
* **Dirigeant personne morale** : pas de contact direct ; son `siren` permet de remonter.

Passez `contact.ref` tel quel à [`POST /v1/contacts`](https://docs.urbanora.fr/guides/contacts). Il est signé : inutile de le construire ou de le modifier.

## Temps de réponse

Deux à quatre secondes pour une fiche complète sur un grand immeuble ; moins avec `donnees`. Les sources sont mises en cache cinq minutes.


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