---
title: "Lots d'un immeuble établis par ses DPE"
method: GET
path: "/adresses/{cle_ban}/lots"
---

# Lots d'un immeuble établis par ses DPE

`GET /adresses/{cle_ban}/lots`

## Request

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

Les lots d'un immeuble à une adresse (clé BAN), établis par les DPE de ses logements (ADEME) : un lot par DPE d'appartement de moins de 10 ans, surface, étiquette, étage, numéros de DPE ; un DPE remplacé rejoint le lot de son remplaçant. Deux DPE du même étage à la même surface sans lien de remplacement sont signalés comme doublon possible, jamais fusionnés. Le compte est confronté au registre des copropriétés et au DPE de l'immeuble ; chaque écart est dit dans desaccords. 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
  - `cle_ban` string, required
  - `adresse` string, nullable, required
  - `insee` string, required
  - `nb_lots` integer, required
  - `lots` object[], required
    - `surface_m2` number, nullable, required
    - `etiquette_dpe` string, nullable, required
    - `etage` integer, nullable, required: Étage porté par le DPE, 0 pour le rez-de-chaussée ; null s'il ne le dit pas.
    - `dpe` object[], required: Le DPE en vigueur d'abord, puis ceux qu'il remplace.
      - `numero_dpe` string, required
      - `date` string, nullable, required
      - `etiquette_dpe` string, nullable, required
      - `surface_m2` number, nullable, required
    - `confiance` 'distinct' | 'doublon_possible', required: doublon_possible : un autre lot du même étage, à la même surface à 1 m² près, porte un DPE d'une autre date sans dire qu'il le remplace.
  - `nb_dpe_ecartes` integer, required: DPE de l'adresse non retenus : hors appartement, de plus de 10 ans, trop petits, ou remplacés.
  - `registre` object, required: Ce que disent le registre des copropriétés et le DPE de l'immeuble, pour contrôler le compte des lots.
    - `lots_habitation` integer, nullable, required: Lots d'habitation déclarés au registre national des copropriétés.
    - `immatriculation` string, nullable, required
    - `logements_dpe_immeuble` integer, nullable, required: Nombre d'appartements que le DPE le plus récent attribue à l'immeuble, quand il en décrit plusieurs.
  - `desaccords` string[], required
  - `methode` string, 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.
  - `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

---

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