---
title: "Prime de division d'une commune"
method: GET
path: "/communes/{insee}/prime-division"
---

# Prime de division d'une commune

`GET /communes/{insee}/prime-division`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/communes/{insee}/prime-division`
- Auth: HTTP bearer

Prime de division mesurée sur DVF dans une commune : prix au m² médian des mutations d'un seul logement face aux mutations de 4 logements ou plus (ventes en bloc), sur les 3 dernières années, avec le nombre de mutations de chaque côté, la période couverte et la qualité de la mesure. Les médianes sont servies quel que soit le nombre de ventes, avec le drapeau peu_d_observations sous les seuils du dossier immeuble ; sous ces seuils, la mesure du département est servie à côté. Paris, Lyon et Marseille se mesurent sur leurs arrondissements. Le rapport est un plafond, pas un profit. Coût : 2 crédits par appel réussi.

## Path parameters

- `insee` string, required: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

## Response `200`

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

- object
  - `insee` string, required
  - `commune_nom` string, nullable, required
  - `commune` object, required
    - `maille` 'commune' | 'departement', required
    - `code` string, required: Code INSEE de la commune, ou code du département.
    - `prix_m2_unite` number, nullable, required: Prix au m² médian des mutations d'un seul logement (un lot revendu à l'unité), en euros.
    - `prix_m2_bloc` number, nullable, required: Prix au m² médian des mutations de 4 logements ou plus (vente en bloc), en euros.
    - `rapport` number, nullable, required: prix_m2_unite divisé par prix_m2_bloc.
    - `prime_pct` number, nullable, required: Écart du prix à l'unité au prix en bloc, en % du prix en bloc.
    - `n_unite` integer, required: Mutations d'un seul logement retenues.
    - `n_bloc` integer, required: Mutations de 4 logements ou plus retenues.
    - `periode` object, required: Première et dernière mutation retenues.
      - `du` string, nullable, required
      - `au` string, nullable, required
    - `millesimes` integer[], required: Années couvertes par les mutations retenues.
    - `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.
  - `departement` object, nullable, required: Repli départemental, mesuré seulement quand la commune n'atteint pas les seuils du dossier immeuble (ventes à l'unité ou en bloc) ; null sinon.
    - `maille` 'commune' | 'departement', required
    - `code` string, required: Code INSEE de la commune, ou code du département.
    - `prix_m2_unite` number, nullable, required: Prix au m² médian des mutations d'un seul logement (un lot revendu à l'unité), en euros.
    - `prix_m2_bloc` number, nullable, required: Prix au m² médian des mutations de 4 logements ou plus (vente en bloc), en euros.
    - `rapport` number, nullable, required: prix_m2_unite divisé par prix_m2_bloc.
    - `prime_pct` number, nullable, required: Écart du prix à l'unité au prix en bloc, en % du prix en bloc.
    - `n_unite` integer, required: Mutations d'un seul logement retenues.
    - `n_bloc` integer, required: Mutations de 4 logements ou plus retenues.
    - `periode` object, required: Première et dernière mutation retenues.
      - `du` string, nullable, required
      - `au` string, nullable, required
    - `millesimes` integer[], required: Années couvertes par les mutations retenues.
    - `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.
  - `avertissement` string, required
  - `calcule_le` string, required
  - `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 ; Opération coupée sur ce créneau

---

[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)