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

# Plaques et zones

> Résoudre un lieu, lister les immeubles ou copros d'un périmètre, agréger.

Scope `zones`. Trois POST, un même modèle de périmètre. **Pas d'export dump** en v1.

## Périmètre

`area` accepte **un** de ces `kind` :

| `kind` | Corps |
| - | - |
| `insee` | `{ "kind": "insee", "codes_insee": ["69123"] }` |
| `iris` | `{ "kind": "iris", "code_iris": "691230101" }` |
| `bbox` | `{ "kind": "bbox", "bbox": [4.79, 45.72, 4.90, 45.81] }` |
| `polygon` | `{ "kind": "polygon", "geometry": { "type": "Polygon", "coordinates": […] } }` |

## Résoudre un lieu

`POST /v1/zones/resolve` — nom de commune, arrondissement, code postal, rue → codes INSEE et cadre.

```bash theme={null}
curl -sS https://partner.urbanora.fr/v1/zones/resolve \
  -H "X-Api-Key: $URBANORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Villeurbanne"}'
```

## Lister

`POST /v1/zones/search` — entités : `copros`, `buildings`, `occupants`, `parcelles` (et `owners` / `dvf` selon contrat).

```bash theme={null}
curl -sS https://partner.urbanora.fr/v1/zones/search \
  -H "X-Api-Key: $URBANORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": "copros",
    "area": { "kind": "insee", "codes_insee": ["69123"] }
  }'
```

Cas typique : copropriétés d'une métropole, puis [qualify](https://docs.urbanora.fr/guides/qualifier-un-immeuble.md) sur chaque immeuble de la liste.

## Agréger

`POST /v1/zones/aggregate` — totaux sur le même périmètre (immeubles, lots, copros, fibre).

```bash theme={null}
curl -sS https://partner.urbanora.fr/v1/zones/aggregate \
  -H "X-Api-Key: $URBANORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": "copro",
    "area": { "kind": "insee", "codes_insee": ["69123"] }
  }'
```

> [!NOTE]
>
> Les filtres fins (nombre de lots, type de syndic, statut fibre) se passent dans `options` selon l'entité. Le schéma vivant est dans la Référence API.

## Parcours plaque

1. `aggregate` — dimensionner la plaque.
2. `search` (`entity: "copros"`) — liste de travail.
3. `GET /v1/buildings/qualify` sur chaque ligne — syndic et décisionnaires.
4. `GET /v1/syndics/{siren}/portfolio` si vous élargissez au parc d'un syndic.


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