---
title: "Parcelle cadastrale et ce qui s'y rattache"
method: GET
path: "/adresses/{cle_ban}/parcelles"
---

# Parcelle cadastrale et ce qui s'y rattache

`GET /adresses/{cle_ban}/parcelles`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/adresses/{cle_ban}/parcelles`
- Auth: HTTP bearer

Une parcelle cadastrale, par son identifiant à 14 caractères ou par la clé BAN d'une adresse : contenance, section, numéro et géométrie (API Carto de l'IGN, en direct), adresses BAN rattachées, ventes DVF de la parcelle, autorisations d'urbanisme Sitadel qui la citent (demandeur personne morale nommé), copropriétés qui la citent et zone du document d'urbanisme à son point intérieur. Par une clé BAN, la parcelle servie est la première de l'adresse, ou celle qui contient le numéro, et la réponse liste les autres. Coût : 3 crédits par appel réussi.

## Path parameters

- `cle_ban` string, required: Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `id_parcelle` string, required
  - `insee` string, nullable, required
  - `prefixe` string, nullable, required: Préfixe de la commune absorbée ; 000 sinon.
  - `section` string, nullable, required
  - `numero` string, nullable, required
  - `commune` string, nullable, required
  - `contenance_m2` number, nullable, required: Contenance cadastrale (surface du terrain), en m².
  - `geometrie` object, required: Géométrie GeoJSON de la parcelle (WGS 84).
    - `type` 'Polygon' | 'MultiPolygon', required
    - `coordinates` unknown[], required: Coordonnées GeoJSON, en degrés (longitude, latitude).
      - unknown
  - `centre` object, required: Point intérieur de la parcelle.
    - `lat` number, required
    - `lon` number, required
  - `parcelles_adresse` string[], nullable, required: Toutes les parcelles de l'adresse, quand la parcelle est demandée par une clé BAN ; null sinon.
  - `adresses` object[], required: Adresses BAN rattachées à la parcelle.
    - `cle_ban` string, required
    - `adresse` string, nullable, required
  - `ventes` object[], required: Ventes DVF de la parcelle (2021 à 2025), une ligne par local ou culture de la mutation.
    - `id_mutation` string, required
    - `date` string, nullable, required
    - `nature` string, nullable, required
    - `valeur_fonciere` number, nullable, required
    - `type_local` string, nullable, required
    - `surface_bati_m2` number, nullable, required
    - `surface_terrain_m2` number, nullable, required
    - `nombre_lots` integer, nullable, required
    - `prix_atypique` boolean, nullable, required
  - `permis` object[], required: Autorisations d'urbanisme Sitadel dont le dossier cite la parcelle.
    - `numero` string, nullable, required
    - `type` string, nullable, required
    - `date` string, nullable, required
    - `nature` string, nullable, required
    - `logements` integer, nullable, required
    - `demandeur` object, nullable, required: Le demandeur personne morale ; null pour une personne physique, jamais nommée.
      - `denomination` string, nullable, required
      - `siren` string, nullable, required
  - `coproprietes` object[], required: Copropriétés du Registre national qui citent la parcelle.
    - `numero` string, required
    - `nom_usage` string, nullable, required
    - `lots_total` integer, nullable, required
    - `lots_habitation` integer, nullable, required
  - `zone_plu` object, nullable, required: Zone du document d'urbanisme au point intérieur de la parcelle (Géoportail de l'urbanisme) ; null hors zonage connu.
    - `libelle` string, nullable, required
    - `type` string, nullable, required
    - `document` string, nullable, required
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)