French Property DPE

Finds ADEME energy-performance certificates for an address or French municipality.

0.010 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • Find residential DPE records for a French address or municipality.

Avoid when

  • An address can contain several dwellings and therefore several DPE records.

Limitations

  • ADEME republishes data submitted by diagnosticians; an address match does not guarantee identification of the exact dwelling.

Sources and provenance

DPE logements existants - ADEME

data.ademe.fr

API Géoplateforme - Géocodage (BAN/IGN)

data.geopf.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
addressstring

code_inseestring

limitinteger

View full JSON Schema
{
    "type": "object",
    "properties": {
        "address": {
            "type": "string",
            "minLength": 5,
            "maxLength": 250
        },
        "code_insee": {
            "type": "string",
            "pattern": "^(?:[0-9]{5}|2[ABab][0-9]{3})$"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 10
        }
    },
    "anyOf": [
        {
            "required": [
                "address"
            ]
        },
        {
            "required": [
                "code_insee"
            ]
        }
    ],
    "additionalProperties": false
}
Output schema
locationobject

Required

source_statusstring

Required

total_countinteger | null

Required

returned_countinteger | null

Required

truncatedboolean | null

Required

dpearray

Required

generated_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "location": {
            "type": "object",
            "properties": {
                "code_insee": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "address": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "normalized_address": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "postcode": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "city": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "ban_id": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "geocoding_score": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                },
                "longitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                },
                "latitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                }
            },
            "required": [
                "code_insee",
                "address",
                "normalized_address",
                "postcode",
                "city",
                "ban_id",
                "geocoding_score",
                "longitude",
                "latitude"
            ],
            "additionalProperties": false
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok"
            ]
        },
        "total_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "returned_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "truncated": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "dpe": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "numero_dpe": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "etiquette_dpe": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "etiquette_ges": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "date_etablissement": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "date_fin_validite": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "surface_habitable_m2": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "annee_construction": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "type_batiment": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "adresse": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "code_postal": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "code_insee": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "commune": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "consommation_kwh_ep_m2_an": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "emission_ges_kgco2_m2_an": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "numero_dpe",
                    "etiquette_dpe",
                    "etiquette_ges",
                    "date_etablissement",
                    "date_fin_validite",
                    "surface_habitable_m2",
                    "annee_construction",
                    "type_batiment",
                    "adresse",
                    "code_postal",
                    "code_insee",
                    "commune",
                    "consommation_kwh_ep_m2_an",
                    "emission_ges_kgco2_m2_an"
                ],
                "additionalProperties": false
            }
        },
        "generated_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "required": [
        "location",
        "source_status",
        "total_count",
        "returned_count",
        "truncated",
        "dpe",
        "generated_at"
    ],
    "additionalProperties": false
}

Example queries

Find DPE records for 10 rue de la Paix 75002 Paris.