> ## 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    Copropriété    Occupants
                            │
                            ▼
                      Syndic ──► 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, syndic, décisionnaires.

> **[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.
* Pas de tuiles cartographiques ni de webhook contacts en v1.
* Le champ `proprietaires` (personnes morales) n'apparaît que si le scope `owners` est ouvert sur votre contrat.

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.