---
title: "Faits complets d'une adresse"
method: GET
path: "/adresses/{cle_ban}/faits"
---

# Faits complets d'une adresse

`GET /adresses/{cle_ban}/faits`

## Request

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

La ligne complète d'une adresse BAN dans la table d'adresses de Pillr, en groupes : identité (parcelles, îlot, position), bâtiment, DPE détaillé (chauffage, isolation, ventilation, méthode, numéro, historique daté), audit, ventes DVF au numéro avec leur historique, îlot (ventes sur 5 ans, médiane au m² et son nombre de ventes, annonces actives, copropriétés), copropriété, autorisations d'urbanisme avec leur historique, sociétés civiles nommées avec leur SIREN, mise en vente (annonce rattachée, confiance et méthode), contexte de la commune et variables du pré-marché. Le paramètre champs choisit des groupes ou des colonnes. Un seul DPE par adresse : le plus récent. Coût : 5 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.

## Query parameters

- `champs` union: Champs rendus, séparés par des virgules (« prix,surface,analyse.score ») ; tous si absent.
  - string
  - string[]

## Response `200`

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

- object
  - `identite` object
    - `cle_ban` string, required
    - `origine` string, nullable, required: ban : adresse de la BAN ; dpe : adresse connue par un DPE, absente de la BAN.
    - `adresse_numerotee` boolean, nullable, required: Faux pour une pseudo-adresse (voie ou commune seule) : à ne pas lire comme un bâtiment.
    - `adresse` string, nullable, required
    - `numero` string, nullable, required
    - `rep` string, nullable, required
    - `voie` string, nullable, required
    - `code_postal` string, nullable, required
    - `insee` string, nullable, required
    - `commune` string, nullable, required
    - `lieu_dit` string, nullable, required
    - `parcelles` string[], required: Parcelles cadastrales de l'adresse (14 caractères).
    - `type_position` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `ilot` string, nullable, required: Îlot d'environ 100 m (position arrondie au millième de degré).
    - `cell4` string, nullable, required: Cellule d'environ 10 m (position arrondie au dix-millième de degré).
  - `batiment` object
    - `type` string, nullable, required
    - `surface_immeuble_m2` number, nullable, required
    - `periode` string, nullable, required
    - `annee` integer, nullable, required
    - `niveaux` integer, nullable, required
    - `appartements` integer, nullable, required
  - `dpe` object, nullable: Un DPE par adresse ici (le plus récent) : le détail logement par logement est servi par les opérations du domaine DPE.
    - `etiquette` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required
    - `ges` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required
    - `conso_kwh_m2_an` number, nullable, required
    - `ges_kg_m2_an` number, nullable, required
    - `surface_m2` number, nullable, required
    - `chauffage_energie` string, nullable, required
    - `chauffage_installation` string, nullable, required
    - `isolation_enveloppe` string, nullable, required
    - `isolation_murs` string, nullable, required
    - `isolation_menuiseries` string, nullable, required
    - `ventilation` string, nullable, required
    - `methode` string, nullable, required: Méthode d'application du DPE (logement, immeuble, à partir du DPE de l'immeuble).
    - `numero` string, nullable, required: Numéro ADEME du DPE le plus récent.
    - `etabli_le` string, nullable, required
    - `fin_validite` string, nullable, required
    - `premier_le` string, nullable, required
    - `jours_depuis` integer, nullable, required
    - `nb_total` integer, nullable, required
    - `nb_12_mois` integer, nullable, required
    - `nb_6_mois` integer, nullable, required
    - `refait_pendant_validite` boolean, nullable, required
    - `historique` object[], required: Tous les DPE datés de l'adresse, du plus ancien au plus récent.
      - `date` string, required
      - `etiquette` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required
    - `interdiction_location` string, nullable, required: Premier jour où la location d'un logement de cette classe est interdite (AAAA-MM-JJ), selon le calendrier de la loi Climat et résilience en métropole (G 2025, F 2028, E 2034). null : classe sans échéance, DPE absent, ou adresse hors de la métropole (le calendrier des outre-mer n'est pas servi).
    - `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.
  - `audit` object, nullable
    - `etabli_le` string, nullable, required
    - `nb` integer, nullable, required
    - `cout_travaux_max` number, nullable, required
    - `classe_visee` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required
    - `pack_pre_vente` boolean, nullable, required: Un DPE et un audit établis ensemble, comme avant une vente.
    - `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.
  - `ventes` object, nullable: Ventes DVF au numéro, résumées par mutation ; le détail est servi par le domaine Ventes DVF.
    - `n` integer, required
    - `premiere_le` string, nullable, required
    - `derniere` object, nullable, required
      - `date` string, nullable, required
      - `prix` number, nullable, required
      - `type` string, nullable, required
      - `surface_m2` number, nullable, required
      - `prix_m2` number, nullable, required
    - `historique` object[], required
      - `date` string, nullable, required
      - `prix` number, nullable, required
      - `type` string, nullable, required
      - `surface_m2` number, nullable, required
    - `vendu_apres_dpe` boolean, 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.
  - `ilot` object
    - `ventes_5a` integer, nullable, required
    - `mediane_m2_5a` number, nullable, required: Prix au m² médian des ventes de l'îlot sur 5 ans, servi quel que soit le nombre de ventes.
    - `derniere_vente_le` string, nullable, required
    - `anciennete_derniere_vente_j` integer, nullable, required
    - `en_vente` integer, nullable, required: Annonces actives dans l'îlot.
    - `vente_directe` integer, nullable, required: Annonces actives de particuliers dans l'îlot.
    - `copro` boolean, nullable, required
    - `lots_max` integer, nullable, required
    - `sans_syndic` boolean, 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.
  - `copro` object, nullable
    - `immatriculation` string, nullable, required
    - `lots_habitation` integer, nullable, required
    - `lots_total` integer, nullable, required
    - `type_syndic` string, nullable, required
    - `mandat` string, nullable, required
    - `immatriculee_le` string, nullable, required
    - `periode_construction` string, nullable, required
    - `aidee` boolean, nullable, required
  - `permis` object, nullable
    - `n_7a` integer, required
    - `dernier_le` string, nullable, required
    - `dernier_type` string, nullable, required
    - `dernier_nature` string, nullable, required
    - `logements_crees_7a` integer, nullable, required
    - `extension` boolean, nullable, required
    - `piscine` boolean, nullable, required
    - `demandeur_pro` boolean, nullable, required: Au moins une autorisation demandée par une personne morale (SIREN).
    - `historique` object[], required
      - `date` string, nullable, required
      - `type` string, nullable, required
      - `nature` string, nullable, required
      - `logements` integer, 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.
  - `societes_civiles` object, nullable: Sociétés civiles (personnes morales) dont le siège est à l'adresse, nommées avec leur SIREN quand l'avis le porte.
    - `n` integer, required: Sociétés civiles dont le siège est à l'adresse.
    - `derniere_denomination` string, nullable, required
    - `dernier_avis` string, nullable, required
    - `dernier_avis_le` string, nullable, required
    - `radiation_le` string, nullable, required: Dernier avis de radiation ou de dissolution.
    - `procedure_le` string, nullable, required: Dernier avis de procédure collective.
    - `cession_le` string, nullable, required: Dernier avis de vente ou de cession.
    - `societes` object[], required
      - `denomination` string, required
      - `siren` string, nullable, required
      - `forme` string, nullable, required
      - `avis` object[], required
        - `date` string, required
        - `type` 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.
  - `annonce` object, nullable: La mise en vente de l'adresse : déduite du rattachement d'annonces à l'adresse, jamais déclarée par le vendeur. La confiance et la méthode disent comment lire la valeur.
    - `deja_en_vente` boolean, nullable, required: Une annonce en cours est rattachée à l'adresse (concordance ou empreinte active).
    - `mise_en_vente_le` string, nullable, required: Première parution de la mise en vente en cours, lue par l'empreinte de l'adresse.
    - `derniere_parution_le` string, nullable, required
    - `concordante` object, nullable, required: L'annonce rattachée par croisement, avec sa confiance et sa méthode.
      - `active` boolean, nullable, required: L'annonce rattachée est-elle encore en ligne ?
      - `nb` number, nullable, required: Annonces rattachées à l'adresse par cette méthode.
      - `id` string, nullable, required: Identifiant de l'annonce au lac de Pillr.
      - `prix` number, nullable, required
      - `surface_m2` number, nullable, required
      - `type_vendeur` 'professionnel' | 'particulier', nullable, required: Professionnel ou particulier, selon le portail ; null si le portail ne le dit pas.
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
      - `confiance` number, nullable, required: Confiance du rattachement de l'annonce à l'adresse, de 0 à 1.
      - `methode` string, nullable, required: Méthode du rattachement (croisement DVF et DPE, DPE et copropriété, etc.).
    - `empreinte` object, nullable, required: L'annonce reconnue par l'empreinte de l'adresse.
      - `active` boolean, nullable, required
      - `nb` number, nullable, required: Parutions reconnues comme le même bien à cette adresse.
      - `id` string, nullable, required
      - `parue_le` string, nullable, required
      - `prix` number, nullable, required
      - `type_vendeur` 'professionnel' | 'particulier', nullable, required: Professionnel ou particulier, selon le portail ; null si le portail ne le dit pas.
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
    - `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.
  - `commune` object, nullable: Contexte de la commune, au dernier mois calculé.
    - `prix_m2_median` number, nullable, required: Prix au m² médian des annonces de la commune.
    - `dvf_prix_m2_median` number, nullable, required: Prix au m² médian des ventes DVF de la commune.
    - `taux_vacance` number, nullable, required
    - `vente_directe_pct` number, nullable, required: Part des annonces entrées publiées par des particuliers, en %.
    - `entrees` integer, nullable, required
    - `stock` integer, nullable, required
    - `duree_mediane_j` number, nullable, required
    - `mois` 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.
  - `pre_marche` object, nullable: Variables du pré-marché, datées au jour du DPE (la probabilité calibrée est servie par le domaine Pré-marché).
    - `decroissance_age_dpe` number, nullable, required
    - `ventes_ilot_avant_dpe` integer, nullable, required
    - `achat_avant_dpe_le` string, nullable, required
    - `annees_detention_au_dpe` number, nullable, required
    - `dpe_valide_au_dpe` boolean, nullable, required
    - `nb_dpe_365j_avant` integer, nullable, required
    - `sci_connue_au_dpe` boolean, nullable, required
    - `audit_connu_le` string, nullable, required
    - `hors_perimetre` string, nullable, required: Motif d'exclusion du périmètre du pré-marché ; null dans le périmètre.
  - `calcule_le` 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)