Aller au contenu

Documentation

DPE et audits

Les diagnostics de performance énergétique et les audits réglementaires de l'ADEME, à l'adresse, au numéro, autour d'un point, et leur coût de sortie. 4 opérations servies.

Tous les DPE d'une adresse, logement par logement

Essayer en direct
GET/api/v1/adresses/{cle_ban}/dpe

Tous les DPE d'une adresse de la Base Adresse Nationale, logement par logement : numéro, dates, étiquettes énergie et GES, consommation et émissions, surface, type, étage et complément d'adresse, méthode, fin de validité, DPE remplacé, échéance d'interdiction de louer. Sources : DPE de logements existants et neufs et DPE tertiaires portant la clé BAN, DPE d'avant juillet 2021 rapprochés par position (30 m au plus). S'y ajoutent l'historique des étiquettes de l'adresse, ses audits énergétiques (classe visée, coût maximal) et la répartition des DPE de sa commune. Aucun DPE, aucun audit ni aucun historique : 404 ressource_absente, rien n'est débité.

Coût
0 crédit, gratuit avec une clé (donnée publique brute)
Accès
À l'usage ou avec l'abonnement Data
Portée
adresse
Outil MCP
dpe_adresse
Bac à sable
Non
Cache serveur
24 h
Délai maximal
8 s

Paramètres

  • cle_bantexteobligatoire

    Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.

  • sourcesvaleur

    Les sources à lire (existant, neuf, tertiaire, ancien), séparées par des virgules ; toutes par défaut.

Exemple d'appel

curl https://pillr.fr/api/v1/adresses/75108_3559_00055/dpe \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • cle_bantexte
  • adresseobjet ou null
    Afficher les 5 champs
    • inseetexte ou null
    • code_postaltexte ou null
    • communetexte ou null
    • latnombre ou null
    • lonnombre ou null
  • dpeliste d'objets

    Tous les DPE de l'adresse, logement par logement, le plus récent d'abord.

    Afficher les 22 champs
    • numerotexte
    • sourcetexte

      existant, neuf, tertiaire (depuis juillet 2021) ou ancien (avant juillet 2021).

      Valeurs : existant, neuf, tertiaire, ancien

    • etabli_letexte ou null
    • fin_validitetexte ou null
    • remplacetexte ou null

      Numéro du DPE que celui-ci remplace.

    • etiquettetexte ou null

      Valeurs : A, B, C, D, E, F, G

    • gestexte ou null

      Valeurs : A, B, C, D, E, F, G

    • conso_kwh_m2nombre ou null

      Consommation d'énergie primaire, en kWh par m² et par an.

    • ges_kg_m2nombre ou null

      Émissions de gaz à effet de serre, en kg de CO2 par m² et par an.

    • surfacenombre ou null

      Surface habitable du logement (surface utile pour un DPE tertiaire), en m².

    • typetexte ou null

      Type de bâtiment (maison, appartement, immeuble), ou secteur d'activité d'un DPE tertiaire.

    • etageentier ou null
    • complementtexte ou null

      Complément d'adresse du logement (porte, bâtiment), tel que le diagnostiqueur l'écrit.

    • methodetexte ou null
    • periodetexte ou null

      Période de construction.

    • annee_constructionentier ou null
    • chauffagetexte ou null

      Énergie principale du chauffage.

    • rattachementtexte

      cle_ban : le DPE porte la clé BAN de l'adresse ; position : DPE d'avant juillet 2021 rapproché par sa position.

      Valeurs : cle_ban, position

    • distance_mentier ou null

      Distance à l'adresse d'un DPE rapproché par position ; null sinon.

    • interdiction_locationtexte ou null

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

    • mois_restantsentier ou null

      Mois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • historiqueliste d'objets

    Les étiquettes successives de l'adresse, la plus ancienne d'abord.

    Afficher les 2 champs
    • datetexte
    • etiquettetexte ou null

      Valeurs : A, B, C, D, E, F, G

  • auditsliste d'objets
    Afficher les 7 champs
    • n_audittexte
    • etabli_letexte ou null
    • classe_departtexte ou null

      Classe du logement à l'état initial de l'audit.

      Valeurs : A, B, C, D, E, F, G

    • classe_viseetexte ou null

      Meilleure classe atteinte par une étape de l'audit.

      Valeurs : A, B, C, D, E, F, G

    • cout_maxnombre ou null

      Coût cumulé le plus élevé chiffré par l'audit, en euros.

    • etapesentier
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • contexte_communeobjet ou null

    Les DPE de la commune de l'adresse : répartition des étiquettes et part de passoires ; null si indisponible.

    Afficher les 6 champs
    • inseetexte
    • totalentier ou null
    • repartitionobjet
      Afficher les 8 champs
      • Aentier ou null
      • Bentier ou null
      • Centier ou null
      • Dentier ou null
      • Eentier ou null
      • Fentier ou null
      • Gentier ou null
      • non_renseigneentier ou null
    • part_passoires_pctnombre ou null
    • part_f_g_pctnombre ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • limitesliste de textes
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Un DPE par son numéro, ou les DPE d'un disque ou d'une commune

Essayer en direct
GET/api/v1/dpe
GET/api/v1/dpe/{numero_dpe}

Un DPE par son numéro (logement existant ou neuf, tertiaire, ou d'avant juillet 2021) avec toutes ses colonnes ADEME : étiquettes, consommations et émissions par usage et par énergie, coûts, déperditions, isolation, chauffage, eau chaude, ventilation, copropriété, identifiant RNB. Ou les DPE de logements existants autour d'un point (2000 m au plus, le plus proche d'abord) ou dans une commune (le plus récent d'abord), filtrés par étiquette, GES, surface, type de bâtiment et date : le DPE inversé. Le DPE est une donnée publique : servi seul, il est gratuit avec une clé. Avec annonces=true, les annonces dont l'empreinte concorde avec le DPE sont jointes (rapprochement Pillr, facturé à l'élément). Le paramètre champs réduit chaque DPE aux champs demandés.

Coût
0 crédit, gratuit avec une clé (donnée publique brute) ; 1 crédit par élément rendu avec annonces=true (annonces rapprochées par l'empreinte)
Accès
À l'usage ou avec l'abonnement Data
Portée
adresse
Outil MCP
dpe
Bac à sable
Non
Cache serveur
24 h
Délai maximal
15 s

Paramètres de /api/v1/dpe

  • latnombre

    de -90 à 90

  • lonnombre

    de -180 à 180

  • rayon_mentier

    Rayon autour du point, en mètres (250 par défaut).

    de 10 à 2 000

  • inseetexte

    Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

  • etiquettevaleur

    Une ou plusieurs étiquettes A à G, ex. E,F,G.

  • gesvaleur

    Une ou plusieurs étiquettes GES A à G.

  • surface_minnombre

    0 au moins

  • surface_maxnombre

    0 au moins

  • typetexte

    Type de bâtiment du DPE.

    Valeurs : appartement, maison, immeuble

  • depuistexte

    DPE établis à partir de cette date.

  • jusqu_atexte

    DPE établis jusqu'à cette date comprise.

  • annoncesvaleur

    Joindre les annonces dont l'empreinte concorde avec chaque DPE (rapprochement Pillr, facturé à l'élément). Faux par défaut : le DPE seul, gratuit.

    par défaut false

  • limiteentier

    Nombre d'éléments par page (50 au plus).

    de 1 à 50 ; par défaut 20

  • curseurtexte

    Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

    de 1 à 1 024 caractères

  • champsvaleur

    Champs rendus, séparés par des virgules (« prix,surface,analyse.score ») ; tous si absent.

Paramètres de /api/v1/dpe/{numero_dpe}

  • numero_dpetexteobligatoire

    Numéro du DPE à l'ADEME, ex. 2435E0123456X.

Exemple d'appel

curl "https://pillr.fr/api/v1/dpe?insee=76540&etiquette=F" \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • rechercheobjet
    Afficher les 5 champs
    • modetexte

      Valeurs : numero, point, commune

    • inseetexte ou null
    • latnombre ou null
    • lonnombre ou null
    • rayon_mentier ou null
  • donneesliste d'objets
    Afficher les 29 champs
    • numero_dpetexte
    • sourcetextefacultatif

      existant, neuf, tertiaire (depuis juillet 2021) ou ancien (avant juillet 2021).

      Valeurs : existant, neuf, tertiaire, ancien

    • etabli_letexte ou nullfacultatif
    • fin_validitetexte ou nullfacultatif
    • remplacetexte ou nullfacultatif
    • etiquettetexte ou nullfacultatif

      Valeurs : A, B, C, D, E, F, G

    • gestexte ou nullfacultatif

      Valeurs : A, B, C, D, E, F, G

    • conso_kwh_m2nombre ou nullfacultatif
    • ges_kg_m2nombre ou nullfacultatif
    • surfacenombre ou nullfacultatif
    • typetexte ou nullfacultatif
    • periodetexte ou nullfacultatif
    • annee_constructionentier ou nullfacultatif
    • etageentier ou nullfacultatif
    • complementtexte ou nullfacultatif
    • id_rnbtexte ou nullfacultatif

      Identifiant du bâtiment au Référentiel national des bâtiments.

    • coproprietetexte ou nullfacultatif

      Numéro d'immatriculation de la copropriété au registre national.

    • cle_bantexte ou nullfacultatif
    • adresse_bantexte ou nullfacultatif
    • inseetexte ou nullfacultatif
    • code_postaltexte ou nullfacultatif
    • latnombre ou nullfacultatif
    • lonnombre ou nullfacultatif
    • distance_mentier ou nullfacultatif

      Distance au point demandé, en mètres ; null hors d'une recherche autour d'un point.

    • interdiction_locationtexte ou nullfacultatif

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

    • mois_restantsentier ou nullfacultatif

      Mois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.

    • annonces_rattacheesliste d'objetsfacultatif

      Annonces dont l'empreinte (étiquettes, consommation, surface, adresse) concorde avec ce DPE ; toujours vide sans annonces=true.

      Afficher les 4 champs
      • idtexte ou null

        Identifiant de l'annonce sur son portail (lbc:, bienici:, seloger:), quand Pillr le reconnaît.

      • parue_letexte ou null
      • activebooléen ou null
      • ecart_surfacenombre ou null

        Écart entre la surface de l'annonce et celle du DPE, en m².

    • ademeobjetfacultatif

      Toutes les colonnes du DPE telles que l'ADEME les publie (consommations et coûts par usage et par énergie, déperditions, isolation, systèmes).

    • qualiteobjetfacultatif

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • limitesliste de textes
  • curseur_suivanttexte ou null

    Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
  • 503creneau_reserveEn cas de maintenance lourde exceptionnelle, si la réponse n'est pas déjà en cache
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Audits énergétiques et leurs scénarios

Essayer en direct
GET/api/v1/audits/{n_audit}
GET/api/v1/adresses/{cle_ban}/audits

Les audits énergétiques réglementaires de l'ADEME, par numéro d'audit ou à une adresse de la Base Adresse Nationale, avec tous leurs scénarios et leurs étapes de travaux : classe atteinte, consommation, coût de l'étape et coût cumulé, gains de facture et de consommation, travaux décrits par l'auditeur. Ce sont des estimations d'auditeur, pas des devis. Aucun audit : 404 ressource_absente, rien n'est débité.

Coût
3 crédits par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
adresse
Outil MCP
audits_energetiques
Bac à sable
Non
Cache serveur
24 h
Délai maximal
15 s

Paramètres de /api/v1/audits/{n_audit}

  • n_audittexteobligatoire

    Numéro de l'audit énergétique à l'ADEME, ex. A243500000001.

Paramètres de /api/v1/adresses/{cle_ban}/audits

  • cle_bantexteobligatoire

    Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.

Exemple d'appel

curl https://pillr.fr/api/v1/audits/A243500000001 \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • auditsliste d'objets

    Les audits, le plus récent d'abord.

    Afficher les 17 champs
    • n_audittexte
    • etabli_letexte ou null
    • fin_validitetexte ou null
    • remplacetexte ou null
    • numero_dpetexte ou null

      Numéro du DPE de l'état initial.

    • cle_bantexte ou null
    • adresse_bantexte ou null
    • inseetexte ou null
    • typetexte ou null
    • surfacenombre ou null
    • periodetexte ou null
    • zone_climatiquetexte ou null
    • classe_departtexte ou null

      Classe du logement à l'état initial de l'audit.

      Valeurs : A, B, C, D, E, F, G

    • classe_viseetexte ou null

      Meilleure classe atteinte par une étape de l'audit.

      Valeurs : A, B, C, D, E, F, G

    • cout_maxnombre ou null
    • scenariosliste d'objets
      Afficher les 2 champs
      • categorietexte ou null
      • etapesliste d'objets
        Afficher les 11 champs
        • etapetexte ou null

          Étape du parcours de travaux, telle que l'ADEME la nomme.

        • classe_bilantexte ou null

          Classe atteinte à cette étape.

          Valeurs : A, B, C, D, E, F, G

        • gestexte ou null

          Valeurs : A, B, C, D, E, F, G

        • conso_kwh_m2nombre ou null

          Consommation d'énergie primaire après l'étape, en kWh par m² et par an.

        • cout_travauxnombre ou null

          Coût des travaux de l'étape, en euros.

        • couts_cumulesnombre ou null

          Coût cumulé des travaux jusqu'à cette étape, en euros.

        • gain_financiernombre ou null
        • gain_facture_minnombre ou null
        • gain_facture_maxnombre ou null
        • gain_conso_pctnombre ou null

          Gain relatif de consommation, en %.

        • travauxtexte ou null

          Travaux de l'étape, tels que l'auditeur les décrit.

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
  • 503creneau_reserveEn cas de maintenance lourde exceptionnelle, si la réponse n'est pas déjà en cache
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Échéance de location et coût de sortie de passoire

Essayer en direct
POST/api/v1/energie/sortie-passoire

L'échéance d'interdiction de louer d'un logement selon son étiquette (calendrier de la loi Climat et résilience en métropole : G 2025, F 2028, E 2034) et les mois restants. Pour une étiquette E, F ou G, le coût pour atteindre D, C ou B, mesuré sur les audits énergétiques ADEME de logements comparables (type, zone climatique, période de construction) : médiane et quartiles, euros par m², coût à la surface du bien, part des audits qui dépassent la cible, finesse de la cellule retenue. Une estimation d'auditeur, pas un devis. Métropole seulement : le calendrier des outre-mer n'est pas servi.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
adresse
Outil MCP
sortie_passoire
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
24 h
Délai maximal
2 s

Paramètres

  • etiquettetexteobligatoire

    Étiquette DPE du logement.

    Valeurs : A, B, C, D, E, F, G

  • typetexteobligatoire

    appartement ou maison.

    Valeurs : appartement, maison

  • inseetexte

    Code INSEE de la commune : donne la zone climatique et le territoire.

  • zone_climatiquetexte

    Zone climatique H1, H2 ou H3, à défaut du code INSEE (métropole).

    Valeurs : H1, H2, H3

  • periode_constructiontexte

    Période de construction, à défaut de l'année.

    Valeurs : avant_1948, 1948_1974, 1975_2000, apres_2000

  • annee_constructionentier

    de 1 000 à 2 100

  • surfacenombre

    Surface habitable du logement, en m² : ramène le coût au bien.

    10 000 au plus ; plus de 0

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/energie/sortie-passoire \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"etiquette":"F","type":"appartement","insee":"76540","surface":55}'

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "etiquette": "F",
  "interdiction_location": "2028-01-01",
  "mois_restants": 13,
  "sortie": {
    "classe_depart": "F",
    "cibles": [
      {
        "vers": "D",
        "n_audits": 3321,
        "euros": {
          "mediane": 20400,
          "p25": 11700,
          "p75": 31900
        },
        "eur_m2": {
          "mediane": 279,
          "p25": 172,
          "p75": 426
        },
        "surface_mediane_m2": 73,
        "pour_la_surface": {
          "surface_m2": 55,
          "mediane": 15300,
          "p25": 9500,
          "p75": 23400
        },
        "part_au_dela": 0.46,
        "perimetre": "appartements classés F, zone climatique H1",
        "niveau": "sans_periode"
      },
      {
        "vers": "C",
        "n_audits": 3303,
        "euros": {
          "mediane": 28600,
          "p25": 17300,
          "p75": 44000
        },
        "eur_m2": {
          "mediane": 391,
          "p25": 251,
          "p75": 569
        },
        "surface_mediane_m2": 73,
        "pour_la_surface": {
          "surface_m2": 55,
          "mediane": 21500,
          "p25": 13800,
          "p75": 31300
        },
        "part_au_dela": 0.41,
        "perimetre": "appartements classés F, zone climatique H1",
        "niveau": "sans_periode"
      },
      {
        "vers": "B",
        "n_audits": 2854,
        "euros": {
          "mediane": 38100,
          "p25": 25800,
          "p75": 54000
        },
        "eur_m2": {
          "mediane": 506,
          "p25": 364,
          "p75": 679
        },
        "surface_mediane_m2": 76,
        "pour_la_surface": {
          "surface_m2": 55,
          "mediane": 27800,
          "p25": 20000,
          "p75": 37300
        },
        "part_au_dela": null,
        "perimetre": "appartements classés F, zone climatique H1",
        "niveau": "sans_periode"
      }
    ],
    "lecture": "Coût cumulé du parcours le moins cher proposé par l'auditeur pour atteindre au moins la classe visée (scénarios réglementaires principaux). C'est une estimation d'auditeur, pas un devis.",
    "source": "audits énergétiques réglementaires (ADEME) établis entre septembre 2023 et septembre 2026"
  },
  "retenu": {
    "type": "appartement",
    "zone_climatique": "H1",
    "periode": null,
    "surface": 55
  },
  "qualite": {
    "n": 2854,
    "provenance": "estime",
    "incertitude": null,
    "drapeaux": [],
    "methode": "Coût cumulé du parcours le moins cher proposé par l'auditeur pour atteindre au moins la classe visée (scénarios réglementaires principaux). C'est une estimation d'auditeur, pas un devis. Cellule la plus fine qui compte assez d'audits comparables (niveau de chaque cible).",
    "donnees_du": "2026-09-28",
    "source": "audits énergétiques réglementaires (ADEME) établis entre septembre 2023 et septembre 2026"
  },
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 28/09/2026.

Réponse

  • etiquettetexte

    Valeurs : A, B, C, D, E, F, G

  • interdiction_locationtexte ou null

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

  • mois_restantsentier ou null

    Mois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.

  • sortieobjet ou null

    Coût de sortie d'une passoire (classe E, F ou G) vers D, C ou B, mesuré sur les audits énergétiques réglementaires de l'ADEME pour des logements comparables. null hors des classes E à G, pour un type de logement sans comparable, ou hors de la métropole.

    Afficher les 4 champs
    • classe_departtexte

      Valeurs : E, F, G

    • ciblesliste d'objets
      Afficher les 9 champs
      • verstexte

        Classe visée.

        Valeurs : D, C, B

      • n_auditsentier

        Nombre d'audits comparables de la cellule retenue.

      • eurosobjet

        Coût des travaux chiffré par les audits comparables, sur leurs propres surfaces, en euros arrondis à la centaine.

        Afficher les 3 champs
        • medianenombre
        • p25nombre
        • p75nombre
      • eur_m2objet ou null

        Le même coût rapporté à la surface habitable, en euros par m² ; null s'il y a trop peu d'audits avec surface.

        Afficher les 3 champs
        • medianenombre
        • p25nombre
        • p75nombre
      • surface_mediane_m2nombre ou null

        Surface habitable médiane des logements audités.

      • pour_la_surfaceobjet ou null

        Le coût au m² des audits appliqué à la surface du bien, quand elle est connue : le chiffre à citer.

        Afficher les 4 champs
        • surface_m2nombre
        • medianenombre
        • p25nombre
        • p75nombre
      • part_au_delanombre ou null

        Part des audits (0 à 1) dont l'étape chiffrée atteint déjà la classe suivante : le chiffrage dépasse alors la cible.

      • perimetretexte

        Les audits comparables, en clair (type de logement, zone climatique, période de construction).

      • niveautexte

        Finesse de la cellule retenue, de la plus fine (type, zone climatique et période) à la plus large (type seul, France métropolitaine).

        Valeurs : complet, sans_periode, sans_zone, national

    • lecturetexte

      Ce que mesure le chiffre : une estimation d'auditeur, pas un devis.

    • sourcetexte
  • retenuobjet

    Ce qui a été retenu pour choisir les audits comparables.

    Afficher les 4 champs
    • typetexte

      Valeurs : appartement, maison

    • zone_climatiquetexte ou null

      Valeurs : H1, H2, H3

    • periodetexte ou null

      Valeurs : avant_1948, 1948_1974, 1975_2000, apres_2000

    • surfacenombre ou null

      Surface retenue pour ramener le coût au bien ; null hors des bornes des audits.

  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs