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/api/v1/adresses/{cle_ban}/dpeTous 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_bantexteobligatoireClé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.
sourcesvaleurLes 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_bantexteadresseobjet ou nullAfficher les 5 champsMasquer
inseetexte ou nullcode_postaltexte ou nullcommunetexte ou nulllatnombre ou nulllonnombre ou null
dpeliste d'objetsTous les DPE de l'adresse, logement par logement, le plus récent d'abord.
Afficher les 22 champsMasquer
numerotextesourcetexteexistant, neuf, tertiaire (depuis juillet 2021) ou ancien (avant juillet 2021).
Valeurs :
existant,neuf,tertiaire,ancienetabli_letexte ou nullfin_validitetexte ou nullremplacetexte ou nullNuméro du DPE que celui-ci remplace.
etiquettetexte ou nullValeurs :
A,B,C,D,E,F,Ggestexte ou nullValeurs :
A,B,C,D,E,F,Gconso_kwh_m2nombre ou nullConsommation 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 nullSurface habitable du logement (surface utile pour un DPE tertiaire), en m².
typetexte ou nullType de bâtiment (maison, appartement, immeuble), ou secteur d'activité d'un DPE tertiaire.
etageentier ou nullcomplementtexte ou nullComplément d'adresse du logement (porte, bâtiment), tel que le diagnostiqueur l'écrit.
methodetexte ou nullperiodetexte ou nullPériode de construction.
annee_constructionentier ou nullchauffagetexte ou nullÉnergie principale du chauffage.
rattachementtextecle_ban : le DPE porte la clé BAN de l'adresse ; position : DPE d'avant juillet 2021 rapproché par sa position.
Valeurs :
cle_ban,positiondistance_mentier ou nullDistance à l'adresse d'un DPE rapproché par position ; null sinon.
interdiction_locationtexte ou nullPremier 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 nullMois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe 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_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
historiqueliste d'objetsLes étiquettes successives de l'adresse, la plus ancienne d'abord.
Afficher les 2 champsMasquer
datetexteetiquettetexte ou nullValeurs :
A,B,C,D,E,F,G
auditsliste d'objetsAfficher les 7 champsMasquer
n_audittexteetabli_letexte ou nullclasse_departtexte ou nullClasse du logement à l'état initial de l'audit.
Valeurs :
A,B,C,D,E,F,Gclasse_viseetexte ou nullMeilleure classe atteinte par une étape de l'audit.
Valeurs :
A,B,C,D,E,F,Gcout_maxnombre ou nullCoût cumulé le plus élevé chiffré par l'audit, en euros.
etapesentierqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe 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_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
contexte_communeobjet ou nullLes DPE de la commune de l'adresse : répartition des étiquettes et part de passoires ; null si indisponible.
Afficher les 6 champsMasquer
inseetextetotalentier ou nullrepartitionobjetAfficher les 8 champsMasquer
Aentier ou nullBentier ou nullCentier ou nullDentier ou nullEentier ou nullFentier ou nullGentier ou nullnon_renseigneentier ou null
part_passoires_pctnombre ou nullpart_f_g_pctnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe 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_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
limitesliste de textescreditsobjetCré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 champsMasquer
debitesentier0 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'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
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/api/v1/dpe/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
latnombrede -90 à 90
lonnombrede -180 à 180
rayon_mentierRayon autour du point, en mètres (250 par défaut).
de 10 à 2 000
inseetexteCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
etiquettevaleurUne ou plusieurs étiquettes A à G, ex. E,F,G.
gesvaleurUne ou plusieurs étiquettes GES A à G.
surface_minnombre0 au moins
surface_maxnombre0 au moins
typetexteType de bâtiment du DPE.
Valeurs :
appartement,maison,immeubledepuistexteDPE établis à partir de cette date.
jusqu_atexteDPE établis jusqu'à cette date comprise.
annoncesvaleurJoindre 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
limiteentierNombre d'éléments par page (50 au plus).
de 1 à 50 ; par défaut 20
curseurtexteCurseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
de 1 à 1 024 caractères
champsvaleurChamps rendus, séparés par des virgules (« prix,surface,analyse.score ») ; tous si absent.
Paramètres de /api/v1/dpe/{numero_dpe}
numero_dpetexteobligatoireNumé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
rechercheobjetAfficher les 5 champsMasquer
modetexteValeurs :
numero,point,communeinseetexte ou nulllatnombre ou nulllonnombre ou nullrayon_mentier ou null
donneesliste d'objetsAfficher les 29 champsMasquer
numero_dpetextesourcetextefacultatifexistant, neuf, tertiaire (depuis juillet 2021) ou ancien (avant juillet 2021).
Valeurs :
existant,neuf,tertiaire,ancienetabli_letexte ou nullfacultatiffin_validitetexte ou nullfacultatifremplacetexte ou nullfacultatifetiquettetexte ou nullfacultatifValeurs :
A,B,C,D,E,F,Ggestexte ou nullfacultatifValeurs :
A,B,C,D,E,F,Gconso_kwh_m2nombre ou nullfacultatifges_kg_m2nombre ou nullfacultatifsurfacenombre ou nullfacultatiftypetexte ou nullfacultatifperiodetexte ou nullfacultatifannee_constructionentier ou nullfacultatifetageentier ou nullfacultatifcomplementtexte ou nullfacultatifid_rnbtexte ou nullfacultatifIdentifiant du bâtiment au Référentiel national des bâtiments.
coproprietetexte ou nullfacultatifNuméro d'immatriculation de la copropriété au registre national.
cle_bantexte ou nullfacultatifadresse_bantexte ou nullfacultatifinseetexte ou nullfacultatifcode_postaltexte ou nullfacultatiflatnombre ou nullfacultatiflonnombre ou nullfacultatifdistance_mentier ou nullfacultatifDistance au point demandé, en mètres ; null hors d'une recherche autour d'un point.
interdiction_locationtexte ou nullfacultatifPremier 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 nullfacultatifMois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.
annonces_rattacheesliste d'objetsfacultatifAnnonces dont l'empreinte (étiquettes, consommation, surface, adresse) concorde avec ce DPE ; toujours vide sans annonces=true.
Afficher les 4 champsMasquer
idtexte ou nullIdentifiant de l'annonce sur son portail (lbc:, bienici:, seloger:), quand Pillr le reconnaît.
parue_letexte ou nullactivebooléen ou nullecart_surfacenombre ou nullÉcart entre la surface de l'annonce et celle du DPE, en m².
ademeobjetfacultatifToutes les colonnes du DPE telles que l'ADEME les publie (consommations et coûts par usage et par énergie, déperditions, isolation, systèmes).
qualiteobjetfacultatifCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe 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_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
limitesliste de textescurseur_suivanttexte ou nullCurseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
creditsobjetCré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 champsMasquer
debitesentier0 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'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
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/api/v1/audits/{n_audit}/api/v1/adresses/{cle_ban}/auditsLes 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_audittexteobligatoireNuméro de l'audit énergétique à l'ADEME, ex. A243500000001.
Paramètres de /api/v1/adresses/{cle_ban}/audits
cle_bantexteobligatoireClé 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'objetsLes audits, le plus récent d'abord.
Afficher les 17 champsMasquer
n_audittexteetabli_letexte ou nullfin_validitetexte ou nullremplacetexte ou nullnumero_dpetexte ou nullNuméro du DPE de l'état initial.
cle_bantexte ou nulladresse_bantexte ou nullinseetexte ou nulltypetexte ou nullsurfacenombre ou nullperiodetexte ou nullzone_climatiquetexte ou nullclasse_departtexte ou nullClasse du logement à l'état initial de l'audit.
Valeurs :
A,B,C,D,E,F,Gclasse_viseetexte ou nullMeilleure classe atteinte par une étape de l'audit.
Valeurs :
A,B,C,D,E,F,Gcout_maxnombre ou nullscenariosliste d'objetsAfficher les 2 champsMasquer
categorietexte ou nulletapesliste d'objetsAfficher les 11 champsMasquer
etapetexte ou nullÉtape du parcours de travaux, telle que l'ADEME la nomme.
classe_bilantexte ou nullClasse atteinte à cette étape.
Valeurs :
A,B,C,D,E,F,Ggestexte ou nullValeurs :
A,B,C,D,E,F,Gconso_kwh_m2nombre ou nullConsommation d'énergie primaire après l'étape, en kWh par m² et par an.
cout_travauxnombre ou nullCoût des travaux de l'étape, en euros.
couts_cumulesnombre ou nullCoût cumulé des travaux jusqu'à cette étape, en euros.
gain_financiernombre ou nullgain_facture_minnombre ou nullgain_facture_maxnombre ou nullgain_conso_pctnombre ou nullGain relatif de consommation, en %.
travauxtexte ou nullTravaux de l'étape, tels que l'auditeur les décrit.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe 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_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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 champsMasquer
debitesentier0 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'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
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/api/v1/energie/sortie-passoireL'é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,Gtypetexteobligatoireappartement ou maison.
Valeurs :
appartement,maisoninseetexteCode INSEE de la commune : donne la zone climatique et le territoire.
zone_climatiquetexteZone climatique H1, H2 ou H3, à défaut du code INSEE (métropole).
Valeurs :
H1,H2,H3periode_constructiontextePériode de construction, à défaut de l'année.
Valeurs :
avant_1948,1948_1974,1975_2000,apres_2000annee_constructionentierde 1 000 à 2 100
surfacenombreSurface 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
etiquettetexteValeurs :
A,B,C,D,E,F,Ginterdiction_locationtexte ou nullPremier 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 nullMois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.
sortieobjet ou nullCoû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 champsMasquer
classe_departtexteValeurs :
E,F,Gciblesliste d'objetsAfficher les 9 champsMasquer
verstexteClasse visée.
Valeurs :
D,C,Bn_auditsentierNombre d'audits comparables de la cellule retenue.
eurosobjetCoût des travaux chiffré par les audits comparables, sur leurs propres surfaces, en euros arrondis à la centaine.
Afficher les 3 champsMasquer
medianenombrep25nombrep75nombre
eur_m2objet ou nullLe 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 champsMasquer
medianenombrep25nombrep75nombre
surface_mediane_m2nombre ou nullSurface habitable médiane des logements audités.
pour_la_surfaceobjet ou nullLe coût au m² des audits appliqué à la surface du bien, quand elle est connue : le chiffre à citer.
Afficher les 4 champsMasquer
surface_m2nombremedianenombrep25nombrep75nombre
part_au_delanombre ou nullPart des audits (0 à 1) dont l'étape chiffrée atteint déjà la classe suivante : le chiffrage dépasse alors la cible.
perimetretexteLes audits comparables, en clair (type de logement, zone climatique, période de construction).
niveautexteFinesse 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
lecturetexteCe que mesure le chiffre : une estimation d'auditeur, pas un devis.
sourcetexte
retenuobjetCe qui a été retenu pour choisir les audits comparables.
Afficher les 4 champsMasquer
typetexteValeurs :
appartement,maisonzone_climatiquetexte ou nullValeurs :
H1,H2,H3periodetexte ou nullValeurs :
avant_1948,1948_1974,1975_2000,apres_2000surfacenombre ou nullSurface retenue pour ramener le coût au bien ; null hors des bornes des audits.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe 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_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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 champsMasquer
debitesentier0 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
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs