---
title: "Audits énergétiques et leurs scénarios"
method: GET
path: "/adresses/{cle_ban}/audits"
---

# Audits énergétiques et leurs scénarios

`GET /adresses/{cle_ban}/audits`

## Request

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

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.

## 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
  - `audits` object[], required: Les audits, le plus récent d'abord.
    - `n_audit` string, required
    - `etabli_le` string, nullable, required
    - `fin_validite` string, nullable, required
    - `remplace` string, nullable, required
    - `numero_dpe` string, nullable, required: Numéro du DPE de l'état initial.
    - `cle_ban` string, nullable, required
    - `adresse_ban` string, nullable, required
    - `insee` string, nullable, required
    - `type` string, nullable, required
    - `surface` number, nullable, required
    - `periode` string, nullable, required
    - `zone_climatique` string, nullable, required
    - `classe_depart` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required: Classe du logement à l'état initial de l'audit.
    - `classe_visee` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required: Meilleure classe atteinte par une étape de l'audit.
    - `cout_max` number, nullable, required
    - `scenarios` object[], required
      - `categorie` string, nullable, required
      - `etapes` object[], required
        - `etape` string, nullable, required: Étape du parcours de travaux, telle que l'ADEME la nomme.
        - `classe_bilan` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required: Classe atteinte à cette étape.
        - `ges` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required
        - `conso_kwh_m2` number, nullable, required: Consommation d'énergie primaire après l'étape, en kWh par m² et par an.
        - `cout_travaux` number, nullable, required: Coût des travaux de l'étape, en euros.
        - `couts_cumules` number, nullable, required: Coût cumulé des travaux jusqu'à cette étape, en euros.
        - `gain_financier` number, nullable, required
        - `gain_facture_min` number, nullable, required
        - `gain_facture_max` number, nullable, required
        - `gain_conso_pct` number, nullable, required: Gain relatif de consommation, en %.
        - `travaux` string, nullable, required: Travaux de l'étape, tels que l'auditeur les décrit.
    - `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.
  - `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 ; Opération coupée sur ce créneau

---

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