Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"Urbanora","description":"API partenaire Urbanora — qualifier un immeuble, identifier le décisionnaire, joindre le contact.","colors":{"primary":"#1d1d1f","light":"#f5f5f7","dark":"#1d1d1f"},"logo":{"light":"https://mintcdn.com/urbanora/dZfl4muqsHLSplSH/logo/light.svg?fit=max\u0026auto=format\u0026n=dZfl4muqsHLSplSH\u0026q=85\u0026s=35ea8131fd90f279e7cf95bccc3530b1","dark":"https://mintcdn.com/urbanora/dZfl4muqsHLSplSH/logo/dark.svg?fit=max\u0026auto=format\u0026n=dZfl4muqsHLSplSH\u0026q=85\u0026s=48b0c946539d113a425bc6243ee8c5ab","href":"https://urbanora.fr"},"favicon":"https://mintcdn.com/urbanora/dZfl4muqsHLSplSH/favicon.png?fit=max\u0026auto=format\u0026n=dZfl4muqsHLSplSH\u0026q=85\u0026s=302c1a7a02e72c729beffcd20d31403f","api":{"openapi":"openapi.json","playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript"]}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://urbanora.fr","label":"urbanora.fr"}]},"search":{"prompt":"Rechercher dans la doc…"},"fonts":{"family":"DM Sans"},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"urbanora","hasAudioNarration":false,"actualSubdomain":"urbanora","customDomains":[],"gitSource":{"type":"github","owner":"zachjve","repo":"gabin-monorepo","deployBranch":"main","contentDirectory":"apps/urbanora-docs","isPrivate":true,"mountPath":"","label":"","_id":"6adf5eb51ae99850ae63cc4a"},"chroma":{"latestBuiltDeploymentHistoryId":"6adf5eb61ae99850ae63cc5a","collectionId":"5b228b9f-55c6-4964-9e76-756b842f9ce1","liveDeploymentHistoryId":"6adf5eb61ae99850ae63cc5a","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adf607070eb839e46bb5c74","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":true,"hasWebMcpPermissions":true,"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":true},"customCss":[],"page":{"pagePath":"api-reference/contacts/rechercher-un-contact-joignable","slug":"/api-reference/contacts/rechercher-un-contact-joignable","pageMetadata":{"title":"Rechercher un contact joignable","description":"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/contacts/find","href":"/api-reference/contacts/rechercher-un-contact-joignable","autogeneratedByOpenApi":true},"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: \"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Rechercher un contact joignable","description":"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/contacts/find","href":"/api-reference/contacts/rechercher-un-contact-joignable","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Rechercher un contact joignable","tags":["contacts"],"description":"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).","requestBody":"0e2c4e27-1142-454f-9d2f-5d9a8950616a","parameters":["668470c0-fdce-4f69-8bab-30c17b19ee36"],"security":["73c95828-d9b0-4542-b05b-a2b976b0e58e"],"responses":{"200":"45f11e84-910a-4884-9475-fae0932b65a1","400":"3c1765dc-ea2e-4eb2-8d22-f3e93e980e13","401":"96d2d21f-b254-4444-b923-020190544623","403":"5245099d-b713-475e-8b10-0082901ca224","429":"8a8eb0bd-de7a-4d61-b227-0444ed3c565a"},"method":"post","type":"path","servers":["06f2f0b0-e2a7-4f6d-8656-8c61baa7a36e","fe0e5cc5-2252-4266-873d-dcd330165789"],"path":"/v1/contacts/find","baseUrlOptions":["https://partner.urbanora.fr","http://127.0.0.1:8086"],"title":"Rechercher un contact joignable","codeSamples":[],"requestExampleLanguages":["bash","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"668470c0-fdce-4f69-8bab-30c17b19ee36":{"schema":{"type":"string","isRequired":false,"description":"Clé d'idempotence. Requise. Rejeu de la réponse pendant 24 h.","uniqueKey":"","typeLabel":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Clé d'idempotence. Requise. Rejeu de la réponse pendant 24 h."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["intent"],"properties":{"intent":{"type":"string","enum":["company_default","person"],"isRequired":true,"uniqueKey":"intent","typeLabel":"enum\u003cstring>"},"siren":{"type":"string","uniqueKey":"siren","typeLabel":"string"},"nom":{"type":"string","uniqueKey":"nom","typeLabel":"string"},"prenom":{"type":"string","uniqueKey":"prenom","typeLabel":"string"},"raison_sociale":{"type":"string","uniqueKey":"raison_sociale","typeLabel":"string"},"forme_juridique":{"type":"string","uniqueKey":"forme_juridique","typeLabel":"string"},"type_contact":{"type":"string","uniqueKey":"type_contact","typeLabel":"string"},"role":{"type":"string","uniqueKey":"role","typeLabel":"string"},"linkedin_url":{"type":"string","uniqueKey":"linkedin_url","typeLabel":"string"},"known_domain":{"type":"string","uniqueKey":"known_domain","typeLabel":"string"},"building_address":{"type":"string","uniqueKey":"building_address","typeLabel":"string"},"batiment_groupe_id":{"type":"string","uniqueKey":"batiment_groupe_id","typeLabel":"string"},"imb_code":{"type":"string","uniqueKey":"imb_code","typeLabel":"string"},"dirigeants":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"nom":{"oneOf":[{"type":"string","uniqueKey":"dirigeants.items.[INDEX].nom.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"dirigeants.items.[INDEX].nom.oneOf.1","typeLabel":"null"}],"uniqueKey":"dirigeants.items.[INDEX].nom","typeLabel":"string | null"},"prenom":{"oneOf":[{"type":"string","uniqueKey":"dirigeants.items.[INDEX].prenom.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"dirigeants.items.[INDEX].prenom.oneOf.1","typeLabel":"null"}],"uniqueKey":"dirigeants.items.[INDEX].prenom","typeLabel":"string | null"},"role":{"oneOf":[{"type":"string","uniqueKey":"dirigeants.items.[INDEX].role.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"dirigeants.items.[INDEX].role.oneOf.1","typeLabel":"null"}],"uniqueKey":"dirigeants.items.[INDEX].role","typeLabel":"string | null"}},"uniqueKey":"dirigeants.items.[INDEX]","typeLabel":"object"},"uniqueKey":"dirigeants","typeLabel":"object[]"},"channels":{"type":"array","items":{"type":"string","enum":["work_email","personal_email","linkedin","mobile"],"uniqueKey":"channels.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"channels","typeLabel":"enum\u003cstring>[]"},"retry":{"type":"boolean","uniqueKey":"retry","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"intent":"company_default","siren":"552032534","channels":["work_email","mobile"]},"examples":{"Example":{"title":"Example","value":{"intent":"company_default","siren":"552032534","channels":["work_email","mobile"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"45f11e84-910a-4884-9475-fae0932b65a1":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["job_id","status","results"],"properties":{"job_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"job_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"job_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job_id","typeLabel":"string | null"},"status":{"type":"string","enum":["accepted","completed","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["kind","mode"],"properties":{"kind":{"type":"string","enum":["establishment","person"],"isRequired":true,"uniqueKey":"results.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"mode":{"type":"string","enum":["sync","async","skipped","already","failed"],"isRequired":true,"uniqueKey":"results.items.[INDEX].mode","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","uniqueKey":"results.items.[INDEX].reason","typeLabel":"string"},"user_message":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].user_message.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].user_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].user_message","typeLabel":"string | null"},"identity_key":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].identity_key.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].identity_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].identity_key","typeLabel":"string | null"},"job_id":{"type":"string","uniqueKey":"results.items.[INDEX].job_id","typeLabel":"string"},"channels":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["type","state","visibility","reliability"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].channels.items.[INDEX].type","typeLabel":"string"},"state":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].channels.items.[INDEX].state","typeLabel":"string"},"visibility":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].channels.items.[INDEX].visibility","typeLabel":"string"},"reliability":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].channels.items.[INDEX].reliability","typeLabel":"string"},"value":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].channels.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].channels.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].channels.items.[INDEX].value","typeLabel":"string | null"},"match_confidence":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].channels.items.[INDEX].match_confidence.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].channels.items.[INDEX].match_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].channels.items.[INDEX].match_confidence","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].channels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].channels","typeLabel":"object[]"},"requested_channels":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].requested_channels.items.[INDEX]","typeLabel":"string"},"uniqueKey":"results.items.[INDEX].requested_channels","typeLabel":"string[]"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"job_id":"\u003cstring>","status":"accepted","results":[{"kind":"establishment","mode":"sync","reason":"\u003cstring>","user_message":"\u003cstring>","identity_key":"\u003cstring>","job_id":"\u003cstring>","channels":[{"type":"\u003cstring>","state":"\u003cstring>","visibility":"\u003cstring>","reliability":"\u003cstring>","value":"\u003cstring>","match_confidence":"\u003cstring>"}],"requested_channels":["\u003cstring>"]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"3c1765dc-ea2e-4eb2-8d22-f3e93e980e13":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"96d2d21f-b254-4444-b923-020190544623":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5245099d-b713-475e-8b10-0082901ca224":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8a8eb0bd-de7a-4d61-b227-0444ed3c565a":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"73c95828-d9b0-4542-b05b-a2b976b0e58e":{"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Clé API partenaire (`upk_live_…` / `upk_test_…`). Alias MCP : `Authorization: Bearer upk_…`.","scopes":[],"schemeName":"apiKey"}}},"servers":{"06f2f0b0-e2a7-4f6d-8656-8c61baa7a36e":{"url":"https://partner.urbanora.fr","description":"Production"},"fe0e5cc5-2252-4266-873d-dcd330165789":{"url":"http://127.0.0.1:8086","description":"Développement"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Clé API partenaire (`upk_live_…` / `upk_test_…`). Alias MCP : `Authorization: Bearer upk_…`.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-Api-Key","type":"string","description":"Clé API partenaire (`upk_live_…` / `upk_test_…`). Alias MCP : `Authorization: Bearer upk_…`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-Api-Key"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"urbanora","siteName":"Urbanora","title":"Rechercher un contact joignable - Urbanora","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T14:15:20.391Z","originalFileLocation":"api-reference/contacts/rechercher-un-contact-joignable.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=\"light\"}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=\"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Urbanora\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_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/urbanora/dVXridH6qPN5AAf-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rechercher un contact joignable - Urbanora\">\u003cmeta data-mint-head property=\"og:description\" content=\"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Urbanora\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://urbanora.mintlify.app/_mintlify/api/og/v2?division=contacts\u0026amp;title=Rechercher+un+contact+joignable\u0026amp;description=Recherche+asynchrone+%28waterfall+interne%29.+Factur%C3%A9+uniquement+si+un+canal+exploitable+est+livr%C3%A9.+%C3%89chec+%3D+0+%E2%82%AC.+D%C3%A9dupliqu%C3%A9+sur+la+p%C3%A9riode+via+le+ledger.+Header+Ide\u0026amp;theme=e11175c6d1d49281777ef2a4\u0026amp;signature=2a65744dd6b475db4301299729ad1ef8a693fe17536590ebd88406de77981835\">\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=\"Rechercher un contact joignable - Urbanora\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://urbanora.mintlify.app/_mintlify/api/og/v2?division=contacts\u0026amp;title=Rechercher+un+contact+joignable\u0026amp;description=Recherche+asynchrone+%28waterfall+interne%29.+Factur%C3%A9+uniquement+si+un+canal+exploitable+est+livr%C3%A9.+%C3%89chec+%3D+0+%E2%82%AC.+D%C3%A9dupliqu%C3%A9+sur+la+p%C3%A9riode+via+le+ledger.+Header+Ide\u0026amp;theme=e11175c6d1d49281777ef2a4\u0026amp;signature=2a65744dd6b475db4301299729ad1ef8a693fe17536590ebd88406de77981835\">\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/urbanora/dVXridH6qPN5AAf-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Urbanora\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1d1d1f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contacts/rechercher-un-contact-joignable.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://urbanora.mintlify.app/#organization\",\"name\":\"Urbanora\",\"url\":\"https://urbanora.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/urbanora/dZfl4muqsHLSplSH/logo/light.svg?fit=max\u0026auto=format\u0026n=dZfl4muqsHLSplSH\u0026q=85\u0026s=35ea8131fd90f279e7cf95bccc3530b1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://urbanora.mintlify.app#website\",\"name\":\"Urbanora\",\"url\":\"https://urbanora.mintlify.app\",\"publisher\":{\"@id\":\"https://urbanora.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable#webpage\",\"url\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable\",\"name\":\"Rechercher un contact joignable\",\"description\":\"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).\",\"dateModified\":\"2026-10-26T14:15:20.391Z\",\"isPartOf\":{\"@id\":\"https://urbanora.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Référence API\",\"item\":\"https://urbanora.mintlify.app/api-reference/meta/mill%C3%A9sime-et-date-dingestion-par-source\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rechercher un contact joignable\",\"item\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable#apireference\",\"headline\":\"Rechercher un contact joignable\",\"name\":\"Rechercher un contact joignable\",\"description\":\"Recherche asynchrone (waterfall interne). Facturé uniquement si un canal exploitable est livré. Échec = 0 €. Dédupliqué sur la période via le ledger. Header Idempotency-Key requis (rejeu 24 h).\",\"url\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable\",\"mainEntityOfPage\":{\"@id\":\"https://urbanora.mintlify.app/api-reference/contacts/rechercher-un-contact-joignable#webpage\"},\"dateModified\":\"2026-10-26T14:15:20.391Z\",\"publisher\":{\"@id\":\"https://urbanora.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://urbanora.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Urbanora\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Urbanora","nav":{"global":null,"groups":[{"group":"Démarrer","icon":"rocket","pages":[{"title":"Introduction","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentification","href":"/authentification"},{"title":"Erreurs et débit","href":"/erreurs"}]},{"group":"Guides","icon":"book-open","pages":[{"title":"Qualifier un immeuble","href":"/guides/qualifier-un-immeuble"},{"title":"Plaques et zones","href":"/guides/plaques-zones"},{"title":"Contacts","href":"/guides/contacts"},{"title":"MCP","href":"/guides/mcp"}]},{"group":"Référence API","icon":"code","pages":[{"group":"meta","pages":[{"title":"Millésime et date d'ingestion par source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/meta/sources","href":"/api-reference/meta/millésime-et-date-dingestion-par-source"},{"title":"Consommation de la période en cours","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/meta/usage","href":"/api-reference/meta/consommation-de-la-période-en-cours"}]},{"group":"buildings","pages":[{"title":"Qualifier un immeuble (fibre, copro, syndic, occupants)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/buildings/qualify","href":"/api-reference/buildings/qualifier-un-immeuble-fibre-copro-syndic-occupants"}]},{"group":"imb","pages":[{"title":"Résolution en lot de codes IMB","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/imb/batch","href":"/api-reference/imb/résolution-en-lot-de-codes-imb"},{"title":"Avancement déploiement (Cartefibre)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/imb/{code}/deployment","href":"/api-reference/imb/avancement-déploiement-cartefibre"},{"title":"Historique des statuts de déploiement","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/imb/{code}/history","href":"/api-reference/imb/historique-des-statuts-de-déploiement"},{"title":"Fiche IMB + éligibilité par opérateur","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/imb/{code}","href":"/api-reference/imb/fiche-imb-+-éligibilité-par-opérateur"}]},{"group":"copros","pages":[{"title":"Fiche copropriété RNIC","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/copros/{numero_immatriculation}","href":"/api-reference/copros/fiche-copropriété-rnic"}]},{"group":"syndics","pages":[{"title":"Toutes les copros gérées par ce syndic","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/syndics/{siren}/portfolio","href":"/api-reference/syndics/toutes-les-copros-gérées-par-ce-syndic"},{"title":"Fiche syndic + dirigeants RNE","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/syndics/{siren}","href":"/api-reference/syndics/fiche-syndic-+-dirigeants-rne"}]},{"group":"search","pages":[{"title":"Géocodage adresse (BAN)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/search/address","href":"/api-reference/search/géocodage-adresse-ban"},{"title":"Recherche IMB par préfixe de code","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/search/imb","href":"/api-reference/search/recherche-imb-par-préfixe-de-code"},{"title":"Recherche entreprise / dirigeant","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/search/companies","href":"/api-reference/search/recherche-entreprise-dirigeant"}]},{"group":"zones","pages":[{"title":"Résoudre un lieu","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/zones/resolve","href":"/api-reference/zones/résoudre-un-lieu"},{"title":"Rechercher dans un périmètre","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/zones/search","href":"/api-reference/zones/rechercher-dans-un-périmètre"},{"title":"Agrégats territoriaux","description":"Totaux sur un périmètre : immeubles, lots, copropriétés, fibre. Même périmètre figé que /search.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/zones/aggregate","href":"/api-reference/zones/agrégats-territoriaux"}]},{"group":"contacts","pages":[{"title":"Rechercher un contact joignable","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/contacts/find","href":"/api-reference/contacts/rechercher-un-contact-joignable"},{"title":"Statut d'un job de contact","description":"Résultat du job de recherche. 404 si le job n'existe pas ou appartient à une autre organisation.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/contacts/jobs/{jobId}","href":"/api-reference/contacts/statut-dun-job-de-contact"},{"title":"Contacts livrés de la période","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/contacts/delivered","href":"/api-reference/contacts/contacts-livrés-de-la-période"}]}]}]},"title":"Rechercher un contact joignable - Urbanora","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}