---
title: "Prix d'un département ou d'une région"
method: GET
path: "/regions/{region}/prix"
---

# Prix d'un département ou d'une région

`GET /regions/{region}/prix`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/regions/{region}/prix`
- Auth: HTTP bearer

Prix médians au m² des appartements et des maisons d'un département ou d'une région, ceux de la carte des prix de Pillr, avec la surface médiane, la population et le nombre de communes, l'emprise, l'indice annuel par type et les coefficients semestriels du barème. Une région se donne par son code INSEE ou son nom court. Coût : 1 crédit par appel réussi.

## Path parameters

- `region` string, required: Code INSEE de la région (53) ou son nom court (bretagne).

## Response `200`

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

- object
  - `niveau` 'departement' | 'region', required
  - `code` string, required
  - `nom` string, nullable, required
  - `region` object, nullable, required
    - `code` string, nullable, required
    - `nom` string, nullable, required
  - `prix_m2_appartement` number, nullable, required
  - `prix_m2_maison` number, nullable, required
  - `surface_mediane_m2` number, nullable, required
  - `population` integer, nullable, required: Population municipale cumulée des communes du territoire (table communale de Pillr).
  - `communes` integer, nullable, required: Communes du territoire dans la table communale de Pillr.
  - `emprise` number[], nullable, required: Emprise du territoire : ouest, sud, est, nord, en degrés.
  - `indice` object[], required
    - `departement` string, required
    - `type` 'appartement' | 'maison', required
    - `annee` integer, required
    - `coef` number, nullable, required
    - `n_ventes` integer, nullable, required
  - `indice_semestriel` object[], required
    - `departement` string, required
    - `type` 'appartement' | 'maison', required
    - `semestre` integer, required
    - `ajustement_log` number, 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)