immo-spot-com · Schema

Dpe

Diagnostic de Performance Énergétique (DPE), issu de la base ADEME. Couvre logements existants, logements neufs et bâtiments tertiaires. Format DPE V3 (opposable). Un DPE est valide 10 ans.

Company

Properties

Name Type Description
etiquette_dpe stringnull Étiquette DPE de A (très performant) à G (très énergivore)
etiquette_ges stringnull Étiquette GES (émissions de gaz à effet de serre) de A à G
conso_kwhep_m2_an numbernull Consommation énergétique en kWhEP/m²/an
emission_ges_kg_co2_m2_an numbernull Émissions de GES en kgCO₂/m²/an
type stringnull Type de DPE : logement-existant, logement-neuf ou tertiaire
modele_dpe stringnull Modèle de méthode de calcul DPE utilisé
version_dpe stringnull Version du logiciel DPE
methode_dpe stringnull Méthode d'application du DPE. Sur les logements, elle décide de la portée des montants absolus : `dpe immeuble collectif` et `dpe issu d'une étude thermique réglementaire RT2012 bâtiment : immeuble` c
date_etablissement_dpe stringnull Date d'établissement du DPE (YYYY-MM-DD)
date_fin_validite_dpe stringnull Date de fin de validité du DPE (YYYY-MM-DD)
type_batiment stringnull Type de bâtiment : maison, appartement, immeuble…
secteur_activite stringnull Secteur d'activité pour les bâtiments tertiaires
annee_construction integernull Année de construction du bâtiment
periode_construction stringnull Période de construction (tranche)
nombre_occupant integernull Nombre d'occupants pris en compte dans le calcul DPE
surface_habitable_logement numbernull Surface habitable du logement en m²
surface_utile numbernull Surface utile en m² (bâtiments tertiaires)
surface_shon numbernull Surface hors œuvre nette en m²
adresse stringnull Adresse retenue par le géocodage BAN. C'est elle qui a produit la position du DPE, donc son rattachement à la parcelle ou à la zone interrogée — voir `geocodage`.
commune_insee stringnull Code INSEE de la commune, issu du géocodage et non de la déclaration : un DPE mal géocodé est rattaché à la commune où le point est tombé.
departement_insee stringnull Code INSEE du département
geocodage object
type_energie_n1 stringnull Énergie principale utilisée
frais_annuel_energie_n1 numbernull Frais annuels estimés pour l'énergie principale, en euros. Montant absolu : sur un DPE établi à l'échelle de l'immeuble, il porte sur tout le bâtiment — voir `methode_dpe`.
type_energie_n2 stringnull Deuxième énergie utilisée (si applicable)
frais_annuel_energie_n2 numbernull Frais annuels estimés pour la deuxième énergie en euros
type_energie_n3 stringnull Troisième énergie utilisée (si applicable)
frais_annuel_energie_n3 numbernull Frais annuels estimés pour la troisième énergie en euros
View JSON Schema on GitHub

JSON Schema

immo-spot-com-dpe-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/immo-spot-com/json-schema/immo-spot-com-dpe-schema.json",
  "title": "Dpe",
  "description": "Diagnostic de Performance Énergétique (DPE), issu de la base ADEME. Couvre logements existants, logements neufs et bâtiments tertiaires. Format DPE V3 (opposable). Un DPE est valide 10 ans.\n",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/immo-spot-com-api-openapi.yml#/components/schemas/Dpe",
  "type": "object",
  "properties": {
    "etiquette_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Étiquette DPE de A (très performant) à G (très énergivore)"
    },
    "etiquette_ges": {
      "type": [
        "string",
        "null"
      ],
      "description": "Étiquette GES (émissions de gaz à effet de serre) de A à G"
    },
    "conso_kwhep_m2_an": {
      "type": [
        "number",
        "null"
      ],
      "description": "Consommation énergétique en kWhEP/m²/an"
    },
    "emission_ges_kg_co2_m2_an": {
      "type": [
        "number",
        "null"
      ],
      "description": "Émissions de GES en kgCO₂/m²/an"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type de DPE : logement-existant, logement-neuf ou tertiaire"
    },
    "modele_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Modèle de méthode de calcul DPE utilisé"
    },
    "version_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Version du logiciel DPE"
    },
    "methode_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Méthode d'application du DPE. Sur les logements, elle décide de la portée des montants absolus : `dpe immeuble collectif` et `dpe issu d'une étude thermique réglementaire RT2012 bâtiment : immeuble` chiffrent le bâtiment entier — frais annuels comme surface — quand les autres méthodes chiffrent un logement. Les consommations au m², elles, restent comparables dans tous les cas.\n"
    },
    "date_etablissement_dpe": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date d'établissement du DPE (YYYY-MM-DD)"
    },
    "date_fin_validite_dpe": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date de fin de validité du DPE (YYYY-MM-DD)"
    },
    "type_batiment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type de bâtiment : maison, appartement, immeuble…"
    },
    "secteur_activite": {
      "type": [
        "string",
        "null"
      ],
      "description": "Secteur d'activité pour les bâtiments tertiaires"
    },
    "annee_construction": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Année de construction du bâtiment"
    },
    "periode_construction": {
      "type": [
        "string",
        "null"
      ],
      "description": "Période de construction (tranche)"
    },
    "nombre_occupant": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Nombre d'occupants pris en compte dans le calcul DPE"
    },
    "surface_habitable_logement": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface habitable du logement en m²"
    },
    "surface_utile": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface utile en m² (bâtiments tertiaires)"
    },
    "surface_shon": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface hors œuvre nette en m²"
    },
    "adresse": {
      "type": [
        "string",
        "null"
      ],
      "description": "Adresse retenue par le géocodage BAN. C'est elle qui a produit la position du DPE, donc son rattachement à la parcelle ou à la zone interrogée — voir `geocodage`.\n"
    },
    "commune_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE de la commune, issu du géocodage et non de la déclaration : un DPE mal géocodé est rattaché à la commune où le point est tombé.\n"
    },
    "departement_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE du département"
    },
    "geocodage": {
      "$ref": "#/$defs/DpeGeocodage"
    },
    "type_energie_n1": {
      "type": [
        "string",
        "null"
      ],
      "description": "Énergie principale utilisée"
    },
    "frais_annuel_energie_n1": {
      "type": [
        "number",
        "null"
      ],
      "description": "Frais annuels estimés pour l'énergie principale, en euros. Montant absolu : sur un DPE établi à l'échelle de l'immeuble, il porte sur tout le bâtiment — voir `methode_dpe`.\n"
    },
    "type_energie_n2": {
      "type": [
        "string",
        "null"
      ],
      "description": "Deuxième énergie utilisée (si applicable)"
    },
    "frais_annuel_energie_n2": {
      "type": [
        "number",
        "null"
      ],
      "description": "Frais annuels estimés pour la deuxième énergie en euros"
    },
    "type_energie_n3": {
      "type": [
        "string",
        "null"
      ],
      "description": "Troisième énergie utilisée (si applicable)"
    },
    "frais_annuel_energie_n3": {
      "type": [
        "number",
        "null"
      ],
      "description": "Frais annuels estimés pour la troisième énergie en euros"
    }
  },
  "$defs": {
    "DpeGeocodage": {
      "type": "object",
      "description": "Comment ce DPE a été rattaché au périmètre demandé, et ce que vaut sa position.\nUn DPE ne porte aucune référence cadastrale : l'ADEME ne connaît du bien que l'adresse saisie par le diagnostiqueur, qu'elle fait géocoder par la BAN. C'est le point ainsi obtenu — et lui seul — qui rattache le diagnostic à une parcelle ou à une zone. Quand le géocodage se trompe, le DPE remonte sur un autre bien, parfois dans un autre département.\nLes deux adresses sont donc rendues : `adresse_declaree` est celle du terrain, `adresse_geocodee` celle qui a placé le point. `incoherent` signale les cas où elles se contredisent (3,8 % des DPE en base).\n",
      "properties": {
        "rattachement": {
          "type": "string",
          "description": "Mode de rattachement au périmètre demandé. Toujours `proximite_geographique` pour les DPE : aucune autre clé ne les relie à une parcelle.\n"
        },
        "adresse_declaree": {
          "type": [
            "string",
            "null"
          ],
          "description": "Adresse du bien telle que le diagnostiqueur l'a saisie, sans retraitement"
        },
        "code_postal_declare": {
          "type": [
            "string",
            "null"
          ],
          "description": "Code postal déclaré par le diagnostiqueur"
        },
        "commune_declaree": {
          "type": [
            "string",
            "null"
          ],
          "description": "Commune déclarée par le diagnostiqueur, en saisie libre"
        },
        "adresse_geocodee": {
          "type": [
            "string",
            "null"
          ],
          "description": "Adresse retenue par la BAN, celle qui a produit la position"
        },
        "score_ban": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Score de géocodage BAN, de 0 à 100. Fourni brut, sans interprétation : mesuré sur l'ensemble de la base, il ne distingue nettement que les scores supérieurs à 90 (0,4 % d'incohérences) et inférieurs à 40 (10,2 %) ; entre les deux le taux oscille entre 2,4 % et 5,9 % sans ordre net. Un score moyen n'indique donc pas une position douteuse.\n"
        },
        "incoherent": {
          "type": "boolean",
          "description": "`true` quand le code postal déclaré et le code postal géocodé se contredisent : la position du DPE est alors probablement fausse, et son rattachement avec elle.\n"
        },
        "avertissement": {
          "type": "string",
          "description": "Message à afficher à l'utilisateur, adapté selon `incoherent`"
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/immo-spot-com-dpe"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.