Bâtiment

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

{
  "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 le faire.

Choisir les données

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

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	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. Ils partagent cette forme :

{
  "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. 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.

Démarrer

Guides

Référence API

Point d’entrée

Réponse

Choisir les données

Entreprises, dirigeants et contacts

Temps de réponse