{"uid":"cap_lczEx7u4nL1cJtQfFhCKB","slug":"greeneris-data-fr-dpe-708671bd","name":"greeneris-data-fr-dpe","description":"Official DPE energy certificates for existing French dwellings from the ADEME dpe03existant dataset (Licence Ouverte 2.0, anonymised). Returns energy class A-G, GHG class, primary-energy consumption kWh/m2/yr, floor area, construction period. Query: ?postal_code=75011 or ?address=48 rue de Montreuil Paris, optional &size=10 (max 50). Spots F/G rental-ban units for real-estate due diligence. Cached 24h.","url":"https://data.greeneris.io/v1/fr/dpe","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"size":{"type":"integer","default":10,"description":"Number of certificates to return (1-50)"},"address":{"type":"string","description":"Free-text address matched against the BAN address field"},"postal_code":{"type":"string","description":"5-digit French postal code, e.g. 75011"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":{"size":5,"address":null,"postal_code":"75011"},"source":"ADEME dpe03existant (data.ademe.fr, Licence Ouverte 2.0)","returned":1,"certificates":[{"numero_dpe":"2675E0077791B","adresse_ban":"48 Rue de Montreuil 75011 Paris","etiquette_dpe":"D","etiquette_ges":"D","type_batiment":"appartement","code_postal_ban":"75011","periode_construction":"1948-1974","date_etablissement_dpe":"2026-01-12","conso_5_usages_par_m2_ep":157,"surface_habitable_logement":63.3,"emission_ges_5_usages_par_m2":31}],"total_matches":55207}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f_4YZPtZzxyqMlsPTJ4s-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves French DPE (energy performance certificates) from the ADEME official registry, filterable by address and postal code","exampleAgentPrompt":"Can you look up the energy performance certificates (DPE) for buildings in postal code 75011 Paris — return me up to 5 results so I can see the energy label, GES rating, and energy consumption per square meter?","exampleUseCases":[{"title":"Real estate agent due diligence checks","prompt":"I'm evaluating a rental property investment at 48 rue de Montreuil, Paris. Can you pull the official DPE certificate to check the energy class and see if it's currently rentable under French regulations?"},{"title":"Property portal listing enrichment","prompt":"We have a batch of apartment listings across the 11th arrondissement of Paris. Can you fetch the DPE ratings and energy consumption data for postal code 75011 so we can display the energy labels on our listings?"},{"title":"Environmental compliance auditing","prompt":"I need to identify all buildings in postal code 75002 that have F or G energy ratings so our sustainability team can flag them for potential retrofit programs. Can you search and show me those records with construction dates and current consumption levels?"}],"resultDescription":"Returns a JSON object with the query parameters echoed back, the ADEME data source citation, the number of certificates returned, and an array of DPE certificate records each containing: certificate number, BAN address, energy label (A-G), GES label (A-G), building type, postal code, construction period, DPE establishment date, energy consumption per m² (5 usages, primary energy), habitable surface in m², and GES emissions per m². Also includes total_matches count for the full result set.","failureModes":["No certificates found for the given address or postal code — returns empty certificates array with total_matches 0","Invalid postal code format (non-5-digit) — may return 400 bad request","Size parameter out of range (below 1 or above 50) — may return validation error","HTTP 402 returned when no payment provided — machine-readable quote with USDC price on Base","Address string too ambiguous to match — returns results from broad matching or empty set","ADEME upstream data temporarily unavailable — may return 503"],"whenToPreferThis":"Use this endpoint when you need official French energy performance certificate data from the ADEME registry for real estate due diligence, property search, environmental compliance checking, or enriching property listings with energy labels. Prefer this over scraped or third-party sources because it uses the official open-data source with Licence Ouverte 2.0. Ideal for AI agents needing pay-per-call access without account registration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:59:47.163Z","isFirstParty":false}