POST /v2/protected/opendata/dpe/match recherche, parmi les DPE de la base ADEME, les candidats les plus proches d’une annonce immobilière donnée. Contrairement à DPE Search qui renvoie une liste paginée et filtrée, Match renvoie les meilleurs candidats classés par similarité et accompagnés d’un score.Le payload sépare deux notions à ne pas confondre :
filters (pré-filtre dur) — exclut les candidats qui ne correspondent pas (géographie, plage de surface, type de bâtiment, plage de dates, codes ADEME/BAN). Un candidat hors de ces bornes n’apparaît jamais dans la réponse.
scoring_targets (ancres douces) — n’excluent rien. Elles influencent uniquement le classement : un candidat proche d’une ancre remonte dans le ranking, un candidat éloigné reste présent mais plus bas.
Chaque résultat porte un score normalisé de 0 à 100 et un confidence (HIGH, MEDIUM, LOW, REJECT). L’objet meta indique le nombre total de candidats trouvés et un drapeau ambiguous, vrai lorsque les deux premiers scores diffèrent de 5 points ou moins — utile pour signaler un match incertain à arbitrer manuellement.Cas d’usage typiques : retrouver le DPE exact d’une annonce, rapprocher un lot d’annonces de leurs DPE pour enrichir un portefeuille, ou estimer l’étiquette énergétique probable d’un bien à partir de ses caractéristiques.
Scoring anchors (conso_5_usages_par_m2_ep/emission_ges_5_usages_par_m2/etiquette_dpe/etiquette_ges/nombre_niveau_immeuble). Influence ranking only — do not exclude candidates.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"API de données immobilières - Fluximmo V2 (2.1.0)","colors":{"primary":"#1E40AF","light":"#1E40AF","dark":"#10B981"},"logo":{"light":"https://mintcdn.com/fluximmo/aO8bUNLwgoFYl98R/images/logo/logo_text.png?fit=max\u0026auto=format\u0026n=aO8bUNLwgoFYl98R\u0026q=85\u0026s=9e831a0d5ca08c0290fd38000a72712d","dark":"https://mintcdn.com/fluximmo/aO8bUNLwgoFYl98R/images/logo/logo_text_light.png?fit=max\u0026auto=format\u0026n=aO8bUNLwgoFYl98R\u0026q=85\u0026s=b1a3fb624a1a3a465264040ed214319e"},"favicon":"https://mintcdn.com/fluximmo/aO8bUNLwgoFYl98R/favicon.png?fit=max\u0026auto=format\u0026n=aO8bUNLwgoFYl98R\u0026q=85\u0026s=fee92f6fee52f069dc369f7055d93c3f","api":{"playground":{"display":"none"}},"background":{"color":{"light":"#F8F8F8","dark":"#090911"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Nous contacter"}],"primary":{"type":"button","label":"Mon compte","href":"https://my.fluximmo.io"}},"footer":{"socials":{"github":"https://github.com/Fluximmo","linkedin":"https://www.linkedin.com/company/fluximmo"}},"seo":{"metatags":{"canonical":"https://doc.fluximmo.io","robots":"index, follow"},"indexing":"all"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fluximmo","hasAudioNarration":false,"actualSubdomain":"fluximmo","customDomains":["doc.fluximmo.io"],"gitSource":{"type":"github","owner":"fluximmo","repo":"public_docs_fluximmo","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a7f5efeca26c86b9715e880","collectionId":"033d4fe4-3dda-42cc-8e9d-0bfd4643d2a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a7f5efeca26c86b9715e880"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a7f5efeca26c86b9715e880:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Documentation","count":74},{"language":"default","tag":"Recherche et alertes","count":35},{"language":"default","tag":"Guides","count":28},{"language":"default","tag":"Properties","count":17},{"language":"default","tag":"Alertes","count":14},{"language":"default","tag":"Adverts","count":13},{"language":"default","tag":"Playbooks","count":9},{"language":"default","tag":"Concepts principaux","count":7},{"language":"default","tag":"Ressources","count":7},{"language":"default","tag":"Refetch","count":6}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière","slug":"/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière","pageMetadata":{"title":"Match DPE à une annonce (V2 stable)","sidebarTitle":"DPE Match","description":"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.","icon":"magnifying-glass-arrow-right","tag":"STABLE","openapi":"post /v2/protected/opendata/dpe/match","href":"/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CodeBlock,Heading,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`à-quoi-ça-sert`,children:`À quoi ça sert`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v2/protected/opendata/dpe/match`}),` recherche, parmi les DPE de la base ADEME, les candidats les plus proches d’une annonce immobilière donnée. Contrairement à `,_jsx(_components.a,{href:`/api-v2-reference/dpe-search/recherche-dpe`,children:`DPE Search`}),` qui renvoie une liste paginée et filtrée, Match renvoie les meilleurs candidats `,_jsx(_components.strong,{children:`classés par similarité`}),` et accompagnés d’un score.`]}),`\n`,_jsx(_components.p,{children:`Le payload sépare deux notions à ne pas confondre :`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`filters`}),` (pré-filtre dur)`]}),` — exclut les candidats qui ne correspondent pas (géographie, plage de surface, type de bâtiment, plage de dates, codes ADEME/BAN). Un candidat hors de ces bornes n’apparaît jamais dans la réponse.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`scoring_targets`}),` (ancres douces)`]}),` — n’excluent rien. Elles influencent uniquement le classement : un candidat proche d’une ancre remonte dans le ranking, un candidat éloigné reste présent mais plus bas.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Chaque résultat porte un `,_jsx(_components.code,{children:`score`}),` normalisé de 0 à 100 et un `,_jsx(_components.code,{children:`confidence`}),` (`,_jsx(_components.code,{children:`HIGH`}),`, `,_jsx(_components.code,{children:`MEDIUM`}),`, `,_jsx(_components.code,{children:`LOW`}),`, `,_jsx(_components.code,{children:`REJECT`}),`). L’objet `,_jsx(_components.code,{children:`meta`}),` indique le nombre total de candidats trouvés et un drapeau `,_jsx(_components.code,{children:`ambiguous`}),`, vrai lorsque les deux premiers scores diffèrent de 5 points ou moins — utile pour signaler un match incertain à arbitrer manuellement.`]}),`\n`,_jsx(_components.p,{children:`Cas d’usage typiques : retrouver le DPE exact d’une annonce, rapprocher un lot d’annonces de leurs DPE pour enrichir un portefeuille, ou estimer l’étiquette énergétique probable d’un bien à partir de ses caractéristiques.`}),`\n`,_jsx(Heading,{level:`2`,id:`payload`,children:`Payload`}),`\n`,_jsx(_components.p,{children:`Le corps de requête est un objet JSON.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Obligatoire`}),_jsx(_components.th,{children:`Sens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`filters`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Non`}),_jsx(_components.td,{children:`Pré-filtre dur. Voir le détail ci-dessous.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Non`}),_jsxs(_components.td,{children:[`Nombre de candidats retournés (1–20, défaut `,_jsx(_components.code,{children:`5`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scoring_targets`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Non`}),_jsx(_components.td,{children:`Ancres de scoring. Voir le détail ci-dessous.`})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`filters-pré-filtre-dur`,children:[_jsx(_components.code,{children:`filters`}),` (pré-filtre dur)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Sens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`code_departement_ban`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Code département BAN (2–3 caractères, ex. `,_jsx(_components.code,{children:`75`}),`, `,_jsx(_components.code,{children:`2A`}),`, `,_jsx(_components.code,{children:`974`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`code_insee_ban`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Code INSEE de la commune (5 caractères).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`code_postal_ban`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Code postal (5 chiffres).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`numero_dpe`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Numéro unique du DPE attribué par l’ADEME. Recherche par identifiant.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type_batiment`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`appartement`}),`, `,_jsx(_components.code,{children:`maison`}),` ou `,_jsx(_components.code,{children:`immeuble`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`surface_habitable_logement`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Plage de surface habitable en m² : `,_jsx(_components.code,{children:`{ \"min\": number, \"max\": number }`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`date_etablissement_dpe`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Plage de dates d’établissement : `,_jsx(_components.code,{children:`{ \"from\": \"YYYY-MM-DD\", \"to\": \"YYYY-MM-DD\" }`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`location`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Filtre géographique : `,_jsx(_components.code,{children:`{ \"lat\": number, \"lon\": number, \"distance\": \"10km\" }`}),`. Unités acceptées : `,_jsx(_components.code,{children:`m`}),`, `,_jsx(_components.code,{children:`km`}),`, `,_jsx(_components.code,{children:`mi`}),`, `,_jsx(_components.code,{children:`ft`}),`, `,_jsx(_components.code,{children:`yd`}),`, `,_jsx(_components.code,{children:`nmi`}),`.`]})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`scoring_targets-ancres-douces`,children:[_jsx(_components.code,{children:`scoring_targets`}),` (ancres douces)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Sens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`conso_5_usages_par_m2_ep`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Consommation cible en kWh/m²/an. Rapproche les candidats à conso proche.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`emission_ges_5_usages_par_m2`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Émissions GES cibles en kgCO₂/m²/an.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`etiquette_dpe`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Étiquette énergie cible (`,_jsx(_components.code,{children:`A`}),`–`,_jsx(_components.code,{children:`G`}),`). Bonus de score si correspondance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`etiquette_ges`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Étiquette GES cible (`,_jsx(_components.code,{children:`A`}),`–`,_jsx(_components.code,{children:`G`}),`). Bonus de score si correspondance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`nombre_niveau_immeuble`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Nombre de niveaux de l’immeuble (0–200).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`numero_etage_appartement`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Étage de l’appartement (−10 à 200 ; valeur négative = sous-sol).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`periode_construction`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Période de construction cible (ex. `,_jsx(_components.code,{children:`avant 1948`}),`, `,_jsx(_components.code,{children:`1948-1974`}),`, `,_jsx(_components.code,{children:`après 2021`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`nombre_niveau_logement`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Nombre de niveaux du logement (0–200).`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`réponse`,children:`Réponse`}),`\n`,_jsxs(_components.p,{children:[`L’API retourne un objet `,_jsx(_components.code,{children:`{ data, meta }`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`data`}),` est un tableau de candidats classés par `,_jsx(_components.code,{children:`score`}),` décroissant. Chaque entrée contient :`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Sens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`score`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Score de similarité normalisé (0–100).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`confidence`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Niveau de confiance : `,_jsx(_components.code,{children:`HIGH`}),`, `,_jsx(_components.code,{children:`MEDIUM`}),`, `,_jsx(_components.code,{children:`LOW`}),` ou `,_jsx(_components.code,{children:`REJECT`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`dpe`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Champs clés du DPE retenu (projection Match).`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`L’objet `,_jsx(_components.code,{children:`dpe`}),` expose notamment `,_jsx(_components.code,{children:`numero_dpe`}),`, `,_jsx(_components.code,{children:`adresse_ban`}),`, `,_jsx(_components.code,{children:`location`}),` (`,_jsx(_components.code,{children:`{ lat, lon }`}),`), `,_jsx(_components.code,{children:`etiquette_dpe`}),`, `,_jsx(_components.code,{children:`etiquette_ges`}),`, `,_jsx(_components.code,{children:`conso_5_usages_par_m2_ep`}),`, `,_jsx(_components.code,{children:`emission_ges_5_usages_par_m2`}),`, `,_jsx(_components.code,{children:`surface_habitable_logement`}),`, `,_jsx(_components.code,{children:`date_etablissement_dpe`}),` et `,_jsx(_components.code,{children:`date_fin_validite_dpe`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`meta`}),` contient :`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Sens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Nombre total de candidats trouvés (au-delà de `,_jsx(_components.code,{children:`size`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ambiguous`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` si les deux premiers scores diffèrent de 5 points ou moins.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Le contrat exact est documenté plus bas par le bloc OpenAPI (`,_jsx(_components.code,{children:`POST /v2/protected/opendata/dpe/match`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`exemple`,children:`Exemple`}),`\n`,_jsx(Heading,{level:`3`,id:`recherche-par-numéro-de-dpe`,children:`Recherche par numéro de DPE`}),`\n`,_jsx(_components.p,{children:`Lookup direct par identifiant ADEME : la recherche court-circuite le scoring et retourne le DPE correspondant.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.fluximmo.io/v2/protected/opendata/dpe/match`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FLUXIMMO_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"filters\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"code_departement_ban\": \"75\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"code_postal_ban\": \"75009\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"numero_dpe\": \"2675E0698907D\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`match-multi-critères-avec-ancres-de-scoring`,children:`Match multi-critères avec ancres de scoring`}),`\n`,_jsx(_components.p,{children:`Pré-filtre dur sur la zone, le type et la plage de surface, puis classement affiné par quatre ancres douces.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.fluximmo.io/v2/protected/opendata/dpe/match`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FLUXIMMO_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"filters\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"code_departement_ban\": \"75\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"code_postal_ban\": \"75011\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type_batiment\": \"appartement\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"surface_habitable_logement\": { \"min\": 45, \"max\": 60 },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"location\": { \"lat\": 48.8592, \"lon\": 2.3789, \"distance\": \"2km\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"scoring_targets\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"etiquette_dpe\": \"D\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"etiquette_ges\": \"C\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"conso_5_usages_par_m2_ep\": 210,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"nombre_niveau_immeuble\": 6`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": 5`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`liens-utiles`,children:`Liens utiles`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-v2-reference/dpe-search/recherche-dpe`,children:`DPE Search — recherche paginée`}),` — liste filtrée de DPE, sans scoring.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/concepts/dvf-vs-fluximmo`,children:`DVF vs Fluximmo`}),` — comprendre les sources de données open data.`]}),`\n`]}),`\n`,_jsx(Card,{title:`Clé test gratuite — 1 semaine`,icon:`key`,href:`https://my.fluximmo.io`,children:_jsxs(_components.p,{children:[`Créez un compte sur `,_jsx(_components.strong,{children:`my.fluximmo.io`}),` pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement requis.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Match DPE à une annonce (V2 stable)","sidebarTitle":"DPE Match","description":"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.","icon":"magnifying-glass-arrow-right","tag":"STABLE","openapi":"post /v2/protected/opendata/dpe/match","href":"/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"À quoi ça sert","slug":"à-quoi-ça-sert","depth":2,"children":[]},{"title":"Payload","slug":"payload","depth":2,"children":[{"title":"filters (pré-filtre dur)","slug":"filters-pré-filtre-dur","depth":3,"children":[]},{"title":"scoring_targets (ancres douces)","slug":"scoring_targets-ancres-douces","depth":3,"children":[]}]},{"title":"Réponse","slug":"réponse","depth":2,"children":[]},{"title":"Exemple","slug":"exemple","depth":2,"children":[{"title":"Recherche par numéro de DPE","slug":"recherche-par-numéro-de-dpe","depth":3,"children":[]},{"title":"Match multi-critères avec ancres de scoring","slug":"match-multi-critères-avec-ancres-de-scoring","depth":3,"children":[]}]},{"title":"Liens utiles","slug":"liens-utiles","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"MatchDpeController_postMatch","summary":"Match DPE à une annonce immobilière","description":"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.","parameters":[],"requestBody":"9c8e762d-a8e1-4551-87b5-29abb12893c4","responses":{"200":"f09b0b9d-58cd-4987-8ea3-4f2657fd1a2a","400":"0065582a-0d24-41fb-b469-ab4fe662c5bd","401":"a6d2c11c-f436-49b3-8faa-3b61ed2d26f8"},"tags":["DPE Match"],"security":["d6884524-af10-4ead-b644-a9c904cf8efb"],"method":"post","type":"path","servers":["031cd211-fbaf-42b4-badc-0611ba772342"],"path":"/v2/protected/opendata/dpe/match","baseUrlOptions":["https://api.fluximmo.io"],"title":"Match DPE à une annonce immobilière","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"object","properties":{"code_departement_ban":{"type":"string","description":"Code du département (BAN, 2-3 caractères, ex : 75, 2A, 974)","example":"75","uniqueKey":"filters.code_departement_ban","typeLabel":"string"},"code_insee_ban":{"type":"string","description":"Code INSEE de la commune (BAN, 5 caractères)","example":"75113","uniqueKey":"filters.code_insee_ban","typeLabel":"string"},"code_postal_ban":{"type":"string","description":"Code postal (BAN, 5 chiffres)","example":"75013","uniqueKey":"filters.code_postal_ban","typeLabel":"string"},"numero_dpe":{"type":"string","description":"Numéro unique du DPE attribué par l'ADEME","example":"2600E0590119C","uniqueKey":"filters.numero_dpe","typeLabel":"string"},"type_batiment":{"type":"string","description":"Type de bâtiment. Possible values: appartement, maison, immeuble","example":"appartement","uniqueKey":"filters.type_batiment","typeLabel":"string"},"surface_habitable_logement":{"type":"object","description":"Surface habitable du logement en m²","example":{"min":57},"properties":{"min":{"type":"number","description":"Minimum value (gte)","uniqueKey":"filters.surface_habitable_logement.min","typeLabel":"number"},"max":{"type":"number","description":"Maximum value (lte)","uniqueKey":"filters.surface_habitable_logement.max","typeLabel":"number"}},"uniqueKey":"filters.surface_habitable_logement","typeLabel":"object"},"date_etablissement_dpe":{"type":"object","description":"Date d'établissement du DPE","example":{"from":"2023-06-15"},"properties":{"from":{"type":"string","format":"date-time","description":"Start date (gte)","uniqueKey":"filters.date_etablissement_dpe.from","typeLabel":"string\u003cdate-time>"},"to":{"type":"string","format":"date-time","description":"End date (lte)","uniqueKey":"filters.date_etablissement_dpe.to","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"filters.date_etablissement_dpe","typeLabel":"object"},"location":{"type":"object","description":"Coordonnées géographiques du bien (latitude, longitude)","required":["lat","lon","distance"],"example":{"lat":48.8566,"lon":2.3522,"distance":"10km"},"properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude","isRequired":true,"uniqueKey":"filters.location.lat","typeLabel":"number"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude","isRequired":true,"uniqueKey":"filters.location.lon","typeLabel":"number"},"distance":{"type":"string","pattern":"^\\d+(\\.\\d+)?(m|km|mi|ft|yd|nmi)$","example":"10km","description":"Distance with unit","isRequired":true,"uniqueKey":"filters.location.distance","typeLabel":"string"}},"uniqueKey":"filters.location","typeLabel":"object"}},"uniqueKey":"filters","typeLabel":"object"},"size":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Page size","uniqueKey":"size","typeLabel":"integer"},"scoring_targets":{"type":"object","description":"Scoring anchors (conso_5_usages_par_m2_ep/emission_ges_5_usages_par_m2/etiquette_dpe/etiquette_ges/nombre_niveau_immeuble). Influence ranking only — do not exclude candidates.","properties":{"conso_5_usages_par_m2_ep":{"type":"number","description":"Scoring anchor (gauss decay, scale=50 kWh/m²). Candidates with similar conso_5_usages_par_m2_ep rank higher.","example":210,"minimum":0,"uniqueKey":"scoring_targets.conso_5_usages_par_m2_ep","typeLabel":"number"},"emission_ges_5_usages_par_m2":{"type":"number","description":"Scoring anchor (gauss decay, scale=10 kgCO₂/m²). Candidates with similar emission_ges_5_usages_par_m2 rank higher.","example":18,"minimum":0,"uniqueKey":"scoring_targets.emission_ges_5_usages_par_m2","typeLabel":"number"},"etiquette_dpe":{"type":"string","description":"Scoring anchor (weighted filter). Candidates matching this DPE label receive a score boost.","enum":["D","E","C","F","G","B","A"],"example":"D","uniqueKey":"scoring_targets.etiquette_dpe","typeLabel":"enum\u003cstring>"},"etiquette_ges":{"type":"string","description":"Scoring anchor (weighted filter). Candidates matching this GES label receive a score boost.","enum":["C","B","D","A","E","F","G"],"example":"C","uniqueKey":"scoring_targets.etiquette_ges","typeLabel":"enum\u003cstring>"},"nombre_niveau_immeuble":{"type":"number","description":"Scoring anchor (weighted filter). Candidates with the same nombre_niveau_immeuble receive a score boost.","example":6,"minimum":0,"maximum":200,"uniqueKey":"scoring_targets.nombre_niveau_immeuble","typeLabel":"number"},"numero_etage_appartement":{"type":"number","description":"Scoring anchor (weighted filter). Candidates with the same numero_etage_appartement receive a score boost. Negative values denote a basement floor.","example":3,"minimum":-10,"maximum":200,"uniqueKey":"scoring_targets.numero_etage_appartement","typeLabel":"number"},"periode_construction":{"type":"string","description":"Scoring anchor (weighted filter). Candidates matching this periode_construction receive a score boost.","enum":["avant 1948","1948-1974","1989-2000","1978-1982","1975-1977","2006-2012","2013-2021","1983-1988","2001-2005","après 2021"],"example":"1948-1974","uniqueKey":"scoring_targets.periode_construction","typeLabel":"enum\u003cstring>"},"nombre_niveau_logement":{"type":"number","description":"Scoring anchor (weighted filter). Candidates with the same nombre_niveau_logement receive a score boost.","example":2,"minimum":0,"maximum":200,"uniqueKey":"scoring_targets.nombre_niveau_logement","typeLabel":"number"}},"uniqueKey":"scoring_targets","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"filters":{"code_departement_ban":"75","code_insee_ban":"75113","code_postal_ban":"75013","numero_dpe":"2600E0590119C","type_batiment":"appartement","surface_habitable_logement":{"min":57},"date_etablissement_dpe":{"from":"2023-06-15"},"location":{"lat":48.8566,"lon":2.3522,"distance":"10km"}},"size":5,"scoring_targets":{"conso_5_usages_par_m2_ep":210,"emission_ges_5_usages_par_m2":18,"etiquette_dpe":"D","etiquette_ges":"C","nombre_niveau_immeuble":6,"numero_etage_appartement":3,"periode_construction":"1948-1974","nombre_niveau_logement":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f09b0b9d-58cd-4987-8ea3-4f2657fd1a2a":{"description":"Candidats DPE classés par score de similarité","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"description":"Candidats DPE classés par score de similarité","type":"array","items":{"type":"object","properties":{"score":{"type":"number","description":"Score normalisé de similarité (0–100)","example":85.3,"isRequired":true,"uniqueKey":"data.items.[INDEX].score","typeLabel":"number"},"confidence":{"type":"string","description":"Niveau de confiance du match","enum":["HIGH","MEDIUM","LOW","REJECT"],"example":"HIGH","isRequired":true,"uniqueKey":"data.items.[INDEX].confidence","typeLabel":"enum\u003cstring>"},"dpe":{"type":"object","description":"Champs clés du DPE (projection MATCH)","properties":{"numero_dpe":{"type":"string","description":"Numéro unique du DPE attribué par l'ADEME","uniqueKey":"data.items.[INDEX].dpe.numero_dpe","typeLabel":"string"},"adresse_ban":{"type":"string","description":"Adresse complète normalisée BAN","uniqueKey":"data.items.[INDEX].dpe.adresse_ban","typeLabel":"string"},"location":{"type":"object","properties":{"lat":{"oneOf":[{"type":"number","uniqueKey":"data.items.[INDEX].dpe.location.lat.oneOf.0","typeLabel":"number"},{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$","uniqueKey":"data.items.[INDEX].dpe.location.lat.oneOf.1","typeLabel":"string"}],"uniqueKey":"data.items.[INDEX].dpe.location.lat","typeLabel":"number | string"},"lon":{"oneOf":[{"type":"number","uniqueKey":"data.items.[INDEX].dpe.location.lon.oneOf.0","typeLabel":"number"},{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$","uniqueKey":"data.items.[INDEX].dpe.location.lon.oneOf.1","typeLabel":"string"}],"uniqueKey":"data.items.[INDEX].dpe.location.lon","typeLabel":"number | string"}},"description":"Coordonnées géographiques du bien (latitude, longitude)","example":{"lat":48.8566,"lon":2.3522},"uniqueKey":"data.items.[INDEX].dpe.location","typeLabel":"object"},"etiquette_dpe":{"type":"string","description":"Étiquette énergie du DPE (A = meilleur, G = pire, N = non applicable)","uniqueKey":"data.items.[INDEX].dpe.etiquette_dpe","typeLabel":"string"},"etiquette_ges":{"type":"string","description":"Étiquette GES du DPE (A = meilleur, G = pire, N = non applicable)","uniqueKey":"data.items.[INDEX].dpe.etiquette_ges","typeLabel":"string"},"conso_5_usages_par_m2_ep":{"type":"number","description":"Consommation des 5 usages en énergie primaire par m² (kWh/m²/an)","uniqueKey":"data.items.[INDEX].dpe.conso_5_usages_par_m2_ep","typeLabel":"number"},"emission_ges_5_usages_par_m2":{"type":"number","description":"Émissions de GES des 5 usages par m² (kgCO₂/m²/an)","uniqueKey":"data.items.[INDEX].dpe.emission_ges_5_usages_par_m2","typeLabel":"number"},"surface_habitable_logement":{"type":"number","description":"Surface habitable du logement en m²","uniqueKey":"data.items.[INDEX].dpe.surface_habitable_logement","typeLabel":"number"},"date_etablissement_dpe":{"type":"string","description":"Date d'établissement du DPE","example":"2023-06-15","format":"date-time","uniqueKey":"data.items.[INDEX].dpe.date_etablissement_dpe","typeLabel":"string\u003cdate-time>"},"date_fin_validite_dpe":{"type":"string","description":"Date de fin de validité du DPE (10 ans après établissement)","example":"2033-06-15","format":"date-time","uniqueKey":"data.items.[INDEX].dpe.date_fin_validite_dpe","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].dpe","typeLabel":"object"}},"required":["score","confidence","dpe"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"meta":{"type":"object","description":"Métadonnées du matching","required":["ambiguous","total"],"properties":{"ambiguous":{"type":"boolean","description":"Indique si les 2 premiers résultats ont des scores proches (écart ≤ 5 points)","example":false,"isRequired":true,"uniqueKey":"meta.ambiguous","typeLabel":"boolean"},"total":{"type":"number","description":"Nombre total de candidats trouvés","example":3,"isRequired":true,"uniqueKey":"meta.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["data","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"score":85.3,"confidence":"HIGH","dpe":{"numero_dpe":"\u003cstring>","adresse_ban":"\u003cstring>","location":{"lat":48.8566,"lon":2.3522},"etiquette_dpe":"\u003cstring>","etiquette_ges":"\u003cstring>","conso_5_usages_par_m2_ep":123,"emission_ges_5_usages_par_m2":123,"surface_habitable_logement":123,"date_etablissement_dpe":"2023-06-15","date_fin_validite_dpe":"2033-06-15"}}],"meta":{"ambiguous":false,"total":3}}}},"exampleType":"generated"}},"exampleType":"generated"},"0065582a-0d24-41fb-b469-ab4fe662c5bd":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","description":"Error object","required":["message","code"],"properties":{"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"number","description":"Error code","isRequired":true,"uniqueKey":"error.code","typeLabel":"number"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"a6d2c11c-f436-49b3-8faa-3b61ed2d26f8":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","description":"Error object","required":["message","code"],"properties":{"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"number","description":"Error code","isRequired":true,"uniqueKey":"error.code","typeLabel":"number"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d6884524-af10-4ead-b644-a9c904cf8efb":{"x_api_key":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"031cd211-fbaf-42b4-badc-0611ba772342":{"url":"https://api.fluximmo.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x_api_key","name":"x-api-key"}],"title":"x_api_key"}]},"originalFileLocation":"swagger-api-v2.json"},"subdomain":"fluximmo","siteName":"API de données immobilières - Fluximmo V2 (2.1.0)","title":"Match DPE à une annonce (V2 stable) - API de données immobilières - Fluximmo V2 (2.1.0)","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-17T07:57:20.340Z","originalFileLocation":"api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.\">\u003cmeta data-mint-head name=\"application-name\" content=\"API de données immobilières - Fluximmo V2 (2.1.0)\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Match DPE à une annonce (V2 stable) - API de données immobilières - Fluximmo V2 (2.1.0)\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API de données immobilières - Fluximmo V2 (2.1.0)\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fluximmo.mintlify.app/_mintlify/api/og/v2?division=DPE\u0026amp;title=Match+DPE+%C3%A0+une+annonce+%28V2+stable%29\u0026amp;description=Retourne+les+DPE+ADEME+les+plus+similaires+%C3%A0+une+annonce+immobili%C3%A8re%2C+class%C3%A9s+par+score+de+similarit%C3%A9+avec+un+niveau+de+confiance.\u0026amp;theme=a9fb4d93d72e13fbe5d17efd\u0026amp;signature=58419358f33d0a9e913bf05f859a6f3800224860eaf753b34f3405dc9c8bc94f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Match DPE à une annonce (V2 stable) - API de données immobilières - Fluximmo V2 (2.1.0)\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fluximmo.mintlify.app/_mintlify/api/og/v2?division=DPE\u0026amp;title=Match+DPE+%C3%A0+une+annonce+%28V2+stable%29\u0026amp;description=Retourne+les+DPE+ADEME+les+plus+similaires+%C3%A0+une+annonce+immobili%C3%A8re%2C+class%C3%A9s+par+score+de+similarit%C3%A9+avec+un+niveau+de+confiance.\u0026amp;theme=a9fb4d93d72e13fbe5d17efd\u0026amp;signature=58419358f33d0a9e913bf05f859a6f3800224860eaf753b34f3405dc9c8bc94f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fluximmo/UFfRiBI6TzVc-rrC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"API de données immobilières - Fluximmo V2 (2.1.0)\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E40AF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://doc.fluximmo.io/#organization\",\"name\":\"API de données immobilières - Fluximmo V2 (2.1.0)\",\"url\":\"https://doc.fluximmo.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fluximmo/aO8bUNLwgoFYl98R/images/logo/logo_text.png?fit=max\u0026auto=format\u0026n=aO8bUNLwgoFYl98R\u0026q=85\u0026s=9e831a0d5ca08c0290fd38000a72712d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://doc.fluximmo.io#website\",\"name\":\"API de données immobilières - Fluximmo V2 (2.1.0)\",\"url\":\"https://doc.fluximmo.io\",\"publisher\":{\"@id\":\"https://doc.fluximmo.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re#webpage\",\"url\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re\",\"name\":\"Match DPE à une annonce (V2 stable)\",\"description\":\"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.\",\"dateModified\":\"2026-05-17T07:57:20.340Z\",\"isPartOf\":{\"@id\":\"https://doc.fluximmo.io#website\"},\"breadcrumb\":{\"@id\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"DPE\",\"item\":\"https://doc.fluximmo.io/api-v2-reference/dpe-search/recherche-dpe\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Match DPE à une annonce (V2 stable)\",\"item\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re#apireference\",\"headline\":\"Match DPE à une annonce (V2 stable)\",\"name\":\"Match DPE à une annonce (V2 stable)\",\"description\":\"Retourne les DPE ADEME les plus similaires à une annonce immobilière, classés par score de similarité avec un niveau de confiance.\",\"url\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re\",\"mainEntityOfPage\":{\"@id\":\"https://doc.fluximmo.io/api-v2-reference/dpe-match/match-dpe-%C3%A0-une-annonce-immobili%C3%A8re#webpage\"},\"dateModified\":\"2026-05-17T07:57:20.340Z\",\"publisher\":{\"@id\":\"https://doc.fluximmo.io/#organization\"},\"isPartOf\":{\"@id\":\"https://doc.fluximmo.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"API de données immobilières - Fluximmo V2 (2.1.0)\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"API de données immobilières - Fluximmo V2 (2.1.0)","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Recherche et alertes","pages":[{"title":"Recherche et alertes","href":"/api-v2-reference/_api-models/property"}]},{"tab":"OpenData","groups":[{"group":"DPE","pages":[{"title":"Recherche DPE — diagnostics énergétiques ADEME (API V2)","sidebarTitle":"Recherche DPE","description":"Recherche filtrée et paginée de Diagnostics de Performance Énergétique (DPE) issus de l'open-data ADEME, enrichis du géocodage BAN.","icon":"magnifying-glass","tag":"STABLE","openapi":"post /v2/protected/opendata/dpe/search","href":"/api-v2-reference/dpe-search/recherche-dpe"},{"title":"Match DPE à une annonce (V2 stable)","sidebarTitle":"DPE Match","icon":"magnifying-glass-arrow-right","tag":"STABLE","openapi":"post /v2/protected/opendata/dpe/match","href":"/api-v2-reference/dpe-match/match-dpe-à-une-annonce-immobilière"}]},{"group":"DVF","pages":[{"title":"Recherche DVF — transactions immobilières notariales","sidebarTitle":"Recherche DVF","description":"Recherche filtrée et paginée des transactions immobilières DVF (prix de vente notariaux) en France.","icon":"magnifying-glass-dollar","tag":"STABLE","openapi":"post /v2/protected/opendata/dvf/search","href":"/api-v2-reference/dvf-search/recherche-dvf"},{"title":"Match DVF à un bien (V2 stable)","sidebarTitle":"Match DVF","icon":"crosshairs","tag":"STABLE","openapi":"post /v2/protected/opendata/dvf/match","href":"/api-v2-reference/dvf-match/match-dvf-à-un-bien-immobilier"}]}]},{"tab":"Analytics","pages":[{"title":"Analytics","href":"/api-analytics-reference/properties-analytics/count-properties-for-search-filters"}]},{"tab":"IA","pages":[{"title":"IA","href":"/api-ai-reference/estimations/lite-property-estimation"}]},{"tab":"Géo","pages":[{"title":"Géo","href":"/api-geocoding-reference/search/recherche-par-géocodage-direct"}]}]},{"anchor":"Nous contacter","icon":"envelope","href":"mailto:[email protected]"}]},"title":"Match DPE à une annonce (V2 stable) - API de données immobilières - Fluximmo V2 (2.1.0)","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}