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

# Introduction

> Une API pour identifier un immeuble, le décisionnaire, et le canal de contact.

Urbanora relie les référentiels publics français du bâti, de la copropriété, de l'entreprise et du réseau. Les jointures — qui n'existent pas nativement — sont établies et maintenues de notre côté.

La chaîne d'identification :

```
Code IMB · adresse · parcelle
              │
              ▼
      Immeuble identifié ──► Fibre · Bâtiment · Occupants
              │
              ▼
   Personnes morales liées à l'immeuble
   Syndic de copropriété · Régie · Propriétaire
              │
              ▼
         Dirigeants
              │
              ▼
           Contact
```

> **[Quickstart](https://docs.urbanora.fr/quickstart.md)**
>
> Une clé, un curl, un immeuble qualifié.

> **[Qualifier un immeuble](https://docs.urbanora.fr/guides/qualifier-un-immeuble.md)**
>
> L'appel pivot : fibre, copro, propriétaires, régie, décisionnaires.

> **[Contacts](https://docs.urbanora.fr/guides/contacts.md)**
>
> Débloquer le canal d'un dirigeant. Facturé seulement si un canal est livré.

> **[MCP](https://docs.urbanora.fr/guides/mcp.md)**
>
> Brancher Cursor ou Claude avec la même clé.

> **[Référence API](https://docs.urbanora.fr/api-reference)**
>
> Chaque endpoint est généré depuis l'OpenAPI — pas de pages rédigées à la main.

## Trois clés d'entrée

L'interrogation démarre indifféremment par :

| Clé | Exemple | Remarque |
| - | - | - |
| Code IMB (ARCEP) | `IMB/13055/X/0042` | Naturel si vous travaillez déjà sur un référentiel opérateur |
| Adresse postale | `12 rue de la République, 13001 Marseille` | Géocodée sur la Base Adresse Nationale |
| Référence de parcelle | `13055000A0123` | Cadastre |

Les trois donnent accès à la même chaîne. **L'absence de code IMB ne bloque pas l'identification du décisionnaire** : elle limite uniquement l'information d'éligibilité fibre.

## Deux accès, un même contrat

| Surface | URL | Auth |
| - | - | - |
| REST JSON | `https://partner.urbanora.fr` | Header `X-Api-Key` |
| MCP (agents) | `https://mcp.urbanora.fr/mcp` | `Authorization: Bearer` (même clé) |

Les périmètres (`scopes`) de la clé s'appliquent aux deux. La référence des routes est le fichier OpenAPI — playground dans la barre **Référence API**.

## Fraîcheur

Chaque source a son rythme de publication. Un endpoint le rend vérifiable :

```bash theme={null}
curl -sS https://partner.urbanora.fr/v1/meta/sources \
  -H "X-Api-Key: upk_live_…"
```

La réponse contient, pour chaque source, le millésime chargé et la date d'ingestion. Pas besoin de nous demander.

Ordres de grandeur (hors SLA contractuel) :

| Domaine | Rythme d'ingestion |
| - | - |
| Copropriétés et syndics | Quotidien (miroir du registre officiel) |
| Entreprises, dirigeants | Quotidien |
| Établissements (stock) | Mensuel |
| Éligibilité fibre | J+1 après publication ARCEP |
| Bâtiments | Millésime courant |

Le registre des copropriétés est **déclaratif**. Nous en livrons un miroir fidèle et daté, sans surcouche d'interprétation.

## Ce que cette API ne fait pas

* Pas de dump de la base, pas d'export France entière.
* Pas de propriétaires personnes physiques. Une personne physique n'apparaît que comme dirigeant d'une personne morale liée à l'immeuble : syndic, régie ou propriétaire.
* Pas de tuiles cartographiques en v1.

Les traitements sont réalisés dans l'Union européenne. Les accords de sous-traitance sont disponibles sur demande.


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