# Urbanora

> API partenaire Urbanora — qualifier un immeuble, identifier le décisionnaire, joindre le contact.

- [Introduction](https://docs.urbanora.fr/index.md): Une API pour identifier un immeuble, le décisionnaire, et le canal de contact.
- [Quickstart](https://docs.urbanora.fr/quickstart.md): Obtenir une clé, qualifier un immeuble, lire la réponse.
- [Authentification](https://docs.urbanora.fr/authentification.md): Clé API, header X-Api-Key, rotation, environnements test et live, Bearer pour le MCP.
- [Erreurs et débit](https://docs.urbanora.fr/erreurs.md): Corps d'erreur normalisé, identifiant de requête, rate-limit, idempotence.
- [Qualifier un immeuble](https://docs.urbanora.fr/guides/qualifier-un-immeuble.md): Un appel, la chaîne complète — fibre, bâtiment, copropriété, syndic, décisionnaires.
- [Plaques et zones](https://docs.urbanora.fr/guides/plaques-zones.md): Résoudre un lieu, lister les immeubles ou copros d'un périmètre, agréger.
- [Contacts](https://docs.urbanora.fr/guides/contacts.md): Recherche asynchrone, facturation au succès, aucun nom de fournisseur.
- [MCP](https://docs.urbanora.fr/guides/mcp.md): Brancher Cursor ou Claude sur Urbanora avec la même clé API.
- [Millésime et date d'ingestion par source](https://docs.urbanora.fr/api-reference/meta/millésime-et-date-dingestion-par-source.md): Fraîcheur des sources : millésime et date d'ingestion. Scope `meta`.
- [Consommation de la période en cours](https://docs.urbanora.fr/api-reference/meta/consommation-de-la-période-en-cours.md): Appels, immeubles qualifiés et contacts livrés de l'organisation de la clé. Scope `meta`.
- [Qualifier un immeuble (fibre, copro, syndic, occupants)](https://docs.urbanora.fr/api-reference/buildings/qualifier-un-immeuble-fibre-copro-syndic-occupants.md): Un appel, une réponse : IMB, fibre, bâtiment, copropriété/syndic, propriétaires, régies, décisionnaires, occupants, fraîcheur. Entrée au choix : `imb_code` | `parcelle_id` | `address` | `lon`+`lat` (un seul mode). Scope `buildings`. Pas de propriétaires personnes physiques, pas de DPE / urbanisme /…
- [Résolution en lot de codes IMB](https://docs.urbanora.fr/api-reference/imb/résolution-en-lot-de-codes-imb.md): Jusqu'à 1000 codes. Encode chaque code IMB (slashes).
- [Avancement déploiement (Cartefibre)](https://docs.urbanora.fr/api-reference/imb/avancement-déploiement-cartefibre.md): État IMB / point de mutualisation (déploiement fibre).
- [Historique des statuts de déploiement](https://docs.urbanora.fr/api-reference/imb/historique-des-statuts-de-déploiement.md): Historique des statuts de déploiement non disponible en v1. Répond 501 NOT_IMPLEMENTED.
- [Fiche IMB + éligibilité par opérateur](https://docs.urbanora.fr/api-reference/imb/fiche-imb-+-éligibilité-par-opérateur.md): Fiche IMB ARCEP : adresse, état de déploiement, éligibilité par opérateur.
- [Fiche copropriété RNIC](https://docs.urbanora.fr/api-reference/copros/fiche-copropriété-rnic.md): Copropriété par numéro d'immatriculation (registre national).
- [Toutes les copros gérées par ce syndic](https://docs.urbanora.fr/api-reference/syndics/toutes-les-copros-gérées-par-ce-syndic.md): Parc RNIC du syndic (SIREN du représentant légal). Endpoint stratégique.
- [Fiche syndic + dirigeants RNE](https://docs.urbanora.fr/api-reference/syndics/fiche-syndic-+-dirigeants-rne.md): Unité légale SIRENE et dirigeants actifs (RNE).
- [Géocodage adresse (BAN)](https://docs.urbanora.fr/api-reference/search/géocodage-adresse-ban.md): Base Adresse Nationale, sans clé. q minimum 3 caractères.
- [Recherche IMB par préfixe de code](https://docs.urbanora.fr/api-reference/search/recherche-imb-par-préfixe-de-code.md): Recherche par préfixe de code IMB (ex. IMB/69123).
- [Recherche entreprise / dirigeant](https://docs.urbanora.fr/api-reference/search/recherche-entreprise-dirigeant.md): SIREN exact ou préfixe de dénomination ; dirigeants à partir de 4 caractères.
- [Résoudre un lieu](https://docs.urbanora.fr/api-reference/zones/résoudre-un-lieu.md): Nom de lieu (commune, arrondissement, code postal, rue) → codes INSEE et cadre approximatif.
- [Rechercher dans un périmètre](https://docs.urbanora.fr/api-reference/zones/rechercher-dans-un-périmètre.md): Recherche multi-entités (copros, immeubles, occupants…) sur un polygone, des codes INSEE, un IRIS ou une bbox. Pas d'export de dump.
- [Agrégats territoriaux](https://docs.urbanora.fr/api-reference/zones/agrégats-territoriaux.md): Totaux sur un périmètre : immeubles, lots, copropriétés, fibre. Même périmètre figé que /search.
- [Rechercher un contact joignable](https://docs.urbanora.fr/api-reference/contacts/rechercher-un-contact-joignable.md): Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).
- [Statut d'un job de contact](https://docs.urbanora.fr/api-reference/contacts/statut-dun-job-de-contact.md): Résultat du job de recherche. 404 si le job n'existe pas ou appartient à une autre organisation.
- [Contacts livrés de la période](https://docs.urbanora.fr/api-reference/contacts/contacts-livrés-de-la-période.md): Ledger facturable de la période en cours. Uniquement les canaux livrés. Un échec n'apparaît pas (0 €).

## OpenAPI Specs

- [openapi](/openapi.json)


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