# French Property DPE Finds ADEME energy-performance certificates for an address or French municipality. ## Endpoint - Method: `POST` - URL: `https://api.helpmyagent.com/v1/real-estate/fr/dpe` - Price: `0.010 USD` / call ## Machine discovery - llms.txt: https://helpmyagent.com/llms.txt - OpenAPI 3.1: https://api.helpmyagent.com/openapi.json - capabilities.json: https://helpmyagent.com/capabilities.json - MCP: https://helpmyagent.com/mcp - RFC 9727: https://helpmyagent.com/.well-known/api-catalog - pricing.json: https://helpmyagent.com/pricing.json - x402: https://helpmyagent.com/.well-known/x402 - x402-service.json: https://helpmyagent.com/.well-known/x402-service.json - Health status: https://helpmyagent.com/health ## x402 payment methods - USDC on `eip155:8453` - RLUSD on `xrpl:0` ## Coverage FR ## Use when - 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. ## Example queries - Find DPE records for 10 rue de la Paix 75002 Paris. ## Freshness ```json { "mode": "source_dependent" } ``` ## Sources - [DPE logements existants - ADEME](https://data.ademe.fr/data-fair/api/v1/datasets/dpe03existant/lines) - [API Géoplateforme - Géocodage (BAN/IGN)](https://data.geopf.fr/geocodage/search) ## Input schema ```json { "type": "object", "properties": { "address": { "type": "string", "minLength": 5, "maxLength": 250, "description": "Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250)." }, "code_insee": { "type": "string", "pattern": "^(?:[0-9]{5}|2[ABab][0-9]{3})$", "description": "Optional value for “code insee” as defined by this API contract." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10, "description": "Maximum number of records returned by this call. (minimum 1; maximum 50; default 10)." } }, "anyOf": [ { "required": [ "address" ] }, { "required": [ "code_insee" ] } ], "additionalProperties": false, "description": "Structured input parameters for the real-estate/fr/dpe API." } ``` ## Output schema ```json { "type": "object", "properties": { "location": { "type": "object", "properties": { "code_insee": { "type": [ "string", "null" ], "description": "Structured value returned for “code insee” as defined by this API contract." }, "address": { "type": [ "string", "null" ], "description": "Structured value returned for “address” as defined by this API contract." }, "normalized_address": { "type": [ "string", "null" ], "description": "Structured value returned for “normalized address” as defined by this API contract." }, "postcode": { "type": [ "string", "null" ], "description": "Structured value returned for “postcode” as defined by this API contract." }, "city": { "type": [ "string", "null" ], "description": "Structured value returned for “city” as defined by this API contract." }, "ban_id": { "type": [ "string", "null" ], "description": "Structured value returned for “ban id” as defined by this API contract." }, "geocoding_score": { "type": [ "number", "integer", "null" ], "description": "Structured value returned for “geocoding score” as defined by this API contract." }, "longitude": { "type": [ "number", "integer", "null" ], "description": "Structured value returned for “longitude” as defined by this API contract." }, "latitude": { "type": [ "number", "integer", "null" ], "description": "Structured value returned for “latitude” as defined by this API contract." } }, "required": [ "code_insee", "address", "normalized_address", "postcode", "city", "ban_id", "geocoding_score", "longitude", "latitude" ], "additionalProperties": false, "description": "Structured value returned for “location” as defined by this API contract." }, "source_status": { "type": "string", "enum": [ "ok" ], "description": "Availability status of the relevant upstream public source. (allowed values: ok)." }, "total_count": { "type": [ "integer", "null" ], "description": "Total number of matching records reported by the source or endpoint." }, "returned_count": { "type": [ "integer", "null" ], "description": "Number of records included in this response." }, "truncated": { "type": [ "boolean", "null" ], "description": "Whether additional matching records existed beyond the returned result limit." }, "dpe": { "type": "array", "items": { "type": "object", "properties": { "numero_dpe": { "type": [ "string", "null" ], "description": "Structured value returned for “numero dpe” as defined by this API contract." }, "etiquette_dpe": { "type": [ "string", "null" ], "description": "Structured value returned for “etiquette dpe” as defined by this API contract." }, "etiquette_ges": { "type": [ "string", "null" ], "description": "Structured value returned for “etiquette ges” as defined by this API contract." }, "date_etablissement": { "type": [ "string", "null" ], "description": "Structured value returned for “date etablissement” as defined by this API contract." }, "date_fin_validite": { "type": [ "string", "null" ], "description": "Structured value returned for “date fin validite” as defined by this API contract." }, "surface_habitable_m2": { "type": [ "number", "integer", "null" ], "description": "Structured value returned for “surface habitable m2” as defined by this API contract." }, "annee_construction": { "type": [ "integer", "null" ], "description": "Structured value returned for “annee construction” as defined by this API contract." }, "type_batiment": { "type": [ "string", "null" ], "description": "Structured value returned for “type batiment” as defined by this API contract." }, "adresse": { "type": [ "string", "null" ], "description": "Structured value returned for “adresse” as defined by this API contract." }, "code_postal": { "type": [ "string", "null" ], "description": "Structured value returned for “code postal” as defined by this API contract." }, "code_insee": { "type": [ "string", "null" ], "description": "Structured value returned for “code insee” as defined by this API contract." }, "commune": { "type": [ "string", "null" ], "description": "Structured value returned for “commune” as defined by this API contract." }, "consommation_kwh_ep_m2_an": { "type": [ "number", "integer", "null" ], "description": "Structured value returned for “consommation kwh ep m2 an” as defined by this API contract." }, "emission_ges_kgco2_m2_an": { "type": [ "number", "integer", "null" ], "description": "Structured value returned for “emission ges kgco2 m2 an” as defined by this API contract." } }, "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 }, "description": "Structured value returned for “dpe” as defined by this API contract." }, "generated_at": { "type": "string", "description": "UTC timestamp at which this derived result was generated." }, "limitations": { "type": "array", "items": { "type": "string" }, "description": "Known interpretation, source-coverage or freshness limitations for this result." } }, "required": [ "location", "source_status", "total_count", "returned_count", "truncated", "dpe", "generated_at" ], "additionalProperties": false, "description": "Structured result returned by the real-estate/fr/dpe API." } ``` ## Request example ```json { "address": "10 rue de la Paix 75002 Paris", "limit": 10 } ``` ## Billing policy ```json { "charge_on": "valid_result", "no_charge_on_empty_result": true, "no_charge_on_error": true } ```