---
title: "Parc de logements d'une commune"
method: GET
path: "/communes/{insee}/parc"
---

# Parc de logements d'une commune

`GET /communes/{insee}/parc`

## Request

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

Parc de logements d'une commune, chaque bloc depuis sa source : résidences principales, secondaires et vacantes, propriétaires et locataires (recensement) ; vacance du parc privé par année, dont plus de deux ans (LOVAC) ; diagnostics de performance énergétique par étiquette, part de passoires et série mensuelle des DPE et des audits (ADEME) ; copropriétés, lots, sans mandat, aidées, en plan de sauvegarde, gérées par un syndic bénévole, en nombre (RNC) ; autorisations et logements créés par mois, permis sur 12 et 24 mois (Sitadel). Les séries partent du mois demandé. 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).

## Query parameters

- `depuis` string: Premier mois des séries mensuelles, AAAA-MM.

## Response `200`

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

- object
  - `insee` string, required: Code INSEE demandé.
  - `commune` string, nullable, required: Nom de la commune ou de l'arrondissement.
  - `logements` object, required
    - `total` integer, nullable, required
    - `residences_principales` integer, nullable, required
    - `residences_secondaires` integer, nullable, required
    - `vacants` integer, nullable, required
    - `occupants_proprietaires` integer, nullable, required
    - `locataires_prive` integer, nullable, required
    - `locataires_hlm` integer, nullable, required
    - `parts_pct` object, required
      - `residences_principales` number, nullable, required
      - `residences_secondaires` number, nullable, required
      - `vacants` number, nullable, required
      - `occupants_proprietaires` number, nullable, required
      - `locataires_prive` number, nullable, required
      - `locataires_hlm` number, nullable, required
    - `millesime` 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.
  - `vacance` object, required
    - `annees` object[], required
      - `annee` integer, required
      - `logements_prives` integer, nullable, required
      - `vacants` integer, nullable, required
      - `vacants_plus_2_ans` integer, nullable, required
      - `taux_pct` 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.
  - `dpe` object, required
    - `total` integer, nullable, required
    - `repartition` object, required
      - `A` integer, nullable, required
      - `B` integer, nullable, required
      - `C` integer, nullable, required
      - `D` integer, nullable, required
      - `E` integer, nullable, required
      - `F` integer, nullable, required
      - `G` integer, nullable, required
      - `non_renseigne` integer, nullable, required
    - `part_fg_pct` number, nullable, required
    - `part_passoires_pct` number, nullable, required
    - `serie` object[], required
      - `mois` string, required
      - `dimension` string, nullable, required
      - `modalite` string, nullable, required
      - `n` integer, nullable, required
      - `source` 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.
  - `coproprietes` object, nullable, required
    - `copros` integer, nullable, required
    - `lots_total` integer, nullable, required
    - `lots_habitation` integer, nullable, required
    - `sans_mandat` integer, nullable, required
    - `aidees` integer, nullable, required
    - `plan_sauvegarde` integer, nullable, required
    - `syndic_benevole` integer, nullable, required: Nombre de copropriétés gérées par un syndic bénévole : un compte, jamais une identité.
    - `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.
  - `construction` object, required
    - `serie` object[], required
      - `mois` string, required
      - `autorisations` integer, nullable, required
      - `logements_crees` integer, nullable, required
      - `individuels` integer, nullable, required
      - `collectifs` integer, nullable, required
      - `demolis` integer, nullable, required
    - `permis_12_mois` integer, nullable, required
    - `permis_24_mois` integer, nullable, required
    - `permis_commences_12_mois` integer, nullable, required
    - `surface_autorisee_12_mois_m2` number, nullable, required
    - `intensite_12_mois` number, nullable, required: Logements autorisés sur 12 mois pour 1 000 habitants.
    - `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.
  - `donnees_du` string, nullable, 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

---

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