---
title: "Terrain de référence d'une maison"
method: GET
path: "/departements/{code}/terrain-reference"
---

# Terrain de référence d'une maison

`GET /departements/{code}/terrain-reference`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/departements/{code}/terrain-reference`
- Auth: HTTP bearer

La surface de terrain médiane d'une maison vendue dans le département, pour le type de commune (groupe déduit du zonage ABC et de la population), telle que le moteur d'estimation la retient : c'est le terrain que le prix du secteur porte déjà. Le niveau dit si la cellule département et groupe est mesurée ou si la médiane nationale du groupe sert de repli. Par commune (code INSEE), ou par département avec le groupe. Coût : 1 crédit par appel réussi.

## Path parameters

- `code` string, required: Code du département (01 à 95, 2A, 2B, 971 à 976).

## Query parameters

- `groupe` 'tendu' | 'B2' | 'C_bourg' | 'C_rural': Groupe de communes, pour une demande par département : tendu (zones A et B1), B2, C_bourg ou C_rural.

## Response `200`

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

- object
  - `m2` number, required: Surface de terrain médiane d'une maison vendue, en m².
  - `groupe` 'tendu' | 'B2' | 'C_bourg' | 'C_rural', required
  - `libelle_groupe` string, required
  - `niveau` 'departement' | 'national', required: departement : cellule mesurée du département ; national : médiane nationale du groupe, faute de ventes assez nombreuses dans la cellule.
  - `departement` string, required
  - `commune` object, nullable, required: La commune demandée et ce qui fixe son groupe ; null pour une demande par département.
    - `insee` string, required
    - `nom` string, nullable, required
    - `zone_abc` string, nullable, required
    - `population` number, nullable, required
  - `mesure` object, required
    - `ventes_total` integer, required: Ventes DVF d'une maison seule retenues pour toute la table.
    - `millesime` integer, required
    - `mesure_le` string, required
    - `seuil_cellule` integer, required: Ventes minimales d'une cellule département et groupe.
  - `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)