Find the mobile advertising IDs seen at an IP address.
Provide an IPv4 or IPv6 ip_address. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address.
Billing: 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.
Mobile advertising IDs seen at the supplied IP address.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Retention.com Enrichment","description":"Enrichment APIs — turn an email, HEM, IP, or LinkedIn profile into emails, profiles, and other attributes.","colors":{"primary":"#111827","light":"#FBBF24","dark":"#0F172A"},"logo":{"light":"https://mintcdn.com/retention/egMTYLJ50XLFHYE0/logo/logo.png?fit=max\u0026auto=format\u0026n=egMTYLJ50XLFHYE0\u0026q=85\u0026s=a4ab393f132873bd76647aa98d1e3239","dark":"https://mintcdn.com/retention/egMTYLJ50XLFHYE0/logo/logo-white.png?fit=max\u0026auto=format\u0026n=egMTYLJ50XLFHYE0\u0026q=85\u0026s=9d30e3a9a3312ad94d0787b98d6b1cd6"},"favicon":"https://mintcdn.com/retention/egMTYLJ50XLFHYE0/favicon.svg?fit=max\u0026auto=format\u0026n=egMTYLJ50XLFHYE0\u0026q=85\u0026s=fbf80f51ecaf717e755de8ff08d94b9d","api":{"openapi":"openapi.json","playground":{"display":"interactive"},"examples":{"languages":["bash","python","javascript"]}},"navbar":{"links":[{"href":"mailto:support@retention.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.retention.com"}},"footer":{"socials":{"x":"https://x.com/retention","linkedin":"https://linkedin.com/company/retention-com"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://ui.api.rb2b.com/dashboard"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"retention","hasAudioNarration":false,"actualSubdomain":"retention","customDomains":[],"gitSource":{"type":"github","owner":"getemailsllc","repo":"api_docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"2952dbaf-8b1e-49e3-a270-1e80b80644c5","liveDeploymentHistoryId":"6ae4ce9af2f7375d4fd9a712","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4ce9af2f7375d4fd9a712"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae4ce9af2f7375d4fd9a712","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"All APIs","count":20},{"language":"default","tag":"Email lookups","count":4},{"language":"default","tag":"Identity Enrichment","count":4},{"language":"default","tag":"Identity Resolution","count":4},{"language":"default","tag":"LinkedIn lookups","count":4},{"language":"default","tag":"Search, activity \u0026 account","count":4},{"language":"default","tag":"Guides","count":1},{"language":"default","tag":"Get started","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/ip/ip-to-maid","slug":"/api-reference/ip/ip-to-maid","pageMetadata":{"title":"IP → Mobile Device IDs","openapi":"POST /api/v1/ip_to_maid","description":"Find the mobile advertising IDs seen at an IP address.\n\nProvide an IPv4 or IPv6 `ip_address`. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address.\n\n**Billing:** 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.","href":"/api-reference/ip/ip-to-maid"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Find the mobile advertising IDs seen at an IP address.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Provide an IPv4 or IPv6 \", _jsx(_components.code, {\n children: \"ip_address\"\n }), \". We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Billing:\"\n }), \" 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.\"]\n })]\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":"IP → Mobile Device IDs","openapi":"POST /api/v1/ip_to_maid","description":"Find the mobile advertising IDs seen at an IP address.\n\nProvide an IPv4 or IPv6 `ip_address`. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address.\n\n**Billing:** 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.","href":"/api-reference/ip/ip-to-maid"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"IP → Mobile Device IDs","tags":["IP"],"operationId":"ipToMaid","description":"Find the mobile advertising IDs seen at an IP address.\n\nProvide an IPv4 or IPv6 `ip_address`. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address.\n\n**Billing:** 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.","security":["5c74ff47-9f9e-491d-84bd-dba264fd2008"],"parameters":[],"responses":{"200":"4d11f573-da3e-4e57-bc1b-858512c174df","400":"b90c9ec3-15b9-4daa-82ed-ec330d0674d6","401":"cbc62a81-1ee5-408c-8d95-e9a665760a22","402":"27e8d272-4822-4c96-aa57-3dc91e8be21d","403":"48a09679-2540-4018-acfb-ceee5a29d238","404":"f899c72b-f218-4f18-b1ea-5afc640c563a"},"requestBody":"2e7a84e3-9ea3-45a0-93aa-16db9dc22aea","method":"post","type":"path","servers":["aa17081d-9c74-404e-b17f-a02fb504f21f"],"path":"/api/v1/ip_to_maid","baseUrlOptions":["https://api.rb2b.com"],"title":"IP → Mobile Device IDs","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ip_address"],"properties":{"ip_address":{"type":"string","description":"IPv4 or IPv6 address of the visitor.","example":"203.0.113.42","isRequired":true,"uniqueKey":"ip_address","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ip_address":"203.0.113.42"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"4d11f573-da3e-4e57-bc1b-858512c174df":{"description":"Matches found (1 credit charged)","content":{"application/json":{"schema":{"type":"object","required":["results"],"properties":{"results":{"type":"array","description":"Mobile advertising IDs seen at the supplied IP address.","items":{"type":"object","description":"Mobile advertising ID (MAID) entry. Either field can be null when only one side of the pair is known.","properties":{"device_id":{"oneOf":[{"type":"string","example":"6D92078A-8246-4BA4-AE5B-76104861E7DC","uniqueKey":"results.items.[INDEX].device_id.oneOf.0","typeLabel":"string"},{"type":"null","example":"6D92078A-8246-4BA4-AE5B-76104861E7DC","uniqueKey":"results.items.[INDEX].device_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].device_id","typeLabel":"string | null"},"device_type":{"oneOf":[{"type":"string","example":"idfa","uniqueKey":"results.items.[INDEX].device_type.oneOf.0","typeLabel":"string"},{"type":"null","example":"idfa","uniqueKey":"results.items.[INDEX].device_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].device_type","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"device_id":"6D92078A-8246-4BA4-AE5B-76104861E7DC","device_type":"idfa"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b90c9ec3-15b9-4daa-82ed-ec330d0674d6":{"description":"Missing or invalid IP","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["missing ip_address","invalid ip_address","unexpected connection error","unexpected error"],"description":"`missing ip_address`: no `ip_address` was provided. `invalid ip_address`: the value is not a valid IPv4 or IPv6 address. `unexpected connection error` / `unexpected error`: temporary error; safe to retry.","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"missing ip_address"}}},"exampleType":"generated"}},"exampleType":"generated"},"cbc62a81-1ee5-408c-8d95-e9a665760a22":{"description":"Missing, malformed, or unknown API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["missing_api_key","invalid_api_key_format","invalid_api_key"],"description":"`missing_api_key`: no key supplied. `invalid_api_key_format`: key does not match the expected format. `invalid_api_key`: key does not belong to any account.","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"missing_api_key"}}},"exampleType":"generated"}},"exampleType":"generated"},"27e8d272-4822-4c96-aa57-3dc91e8be21d":{"description":"Insufficient credits","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["insufficient_api_credits"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"required":{"type":"string","description":"Credits needed for this request.","example":"1.0","uniqueKey":"required","typeLabel":"string"},"remaining":{"type":"string","description":"Credits currently remaining on the account.","example":"0.0","uniqueKey":"remaining","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"insufficient_api_credits","required":"1.0","remaining":"0.0"}}},"exampleType":"generated"}},"exampleType":"generated"},"48a09679-2540-4018-acfb-ceee5a29d238":{"description":"Service not enabled for this API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["service_unavailable_for_key"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"service_unavailable_for_key"}}},"exampleType":"generated"}},"exampleType":"generated"},"f899c72b-f218-4f18-b1ea-5afc640c563a":{"description":"No results (not billed)","content":{"application/json":{"schema":{"type":"object","required":["results"],"properties":{"results":{"type":"array","description":"Always empty; no device IDs found for the supplied IP.","items":{"oneOf":[{}],"uniqueKey":"results.items.[INDEX]","typeLabel":"any"},"maxItems":0,"isRequired":true,"uniqueKey":"results","typeLabel":"any[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":["\u003cunknown>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5c74ff47-9f9e-491d-84bd-dba264fd2008":{"api_key":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Per-account API key. Also accepted as `Api-Key` or `Authorization: Bearer \u003ckey>`.","scopes":[]}}},"servers":{"aa17081d-9c74-404e-b17f-a02fb504f21f":{"url":"https://api.rb2b.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Per-account API key. Also accepted as `Api-Key` or `Authorization: Bearer \u003ckey>`.","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","description":"Per-account API key. Also accepted as `Api-Key` or `Authorization: Bearer \u003ckey>`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api_key","name":"X-Api-Key"}],"title":"api_key"}]},"originalFileLocation":"openapi.json"},"subdomain":"retention","siteName":"Retention.com Enrichment","title":"IP → Mobile Device IDs - Retention.com Enrichment","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T17:06:46.504Z","originalFileLocation":"api-reference/ip/ip-to-maid.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=\"Find the mobile advertising IDs seen at an IP address. Provide an IPv4 or IPv6 ip_address. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address. Billing: 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Retention.com Enrichment\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_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/retention/npq8Vd2x9SJbcBOC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"IP → Mobile Device IDs - Retention.com Enrichment\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find the mobile advertising IDs seen at an IP address. Provide an IPv4 or IPv6 ip_address. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address. Billing: 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Retention.com Enrichment\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://retention.mintlify.app/api-reference/ip/ip-to-maid\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://retention.mintlify.app/_mintlify/api/og/v2?division=Identity+Resolution\u0026amp;title=IP+%E2%86%92+Mobile+Device+IDs\u0026amp;description=Find+the+mobile+advertising+IDs+seen+at+an+IP+address.%0A%0AProvide+an+IPv4+or+IPv6+%60ip_address%60.+We+use+our+proprietary+identity+resolution+technology+to+return+th\u0026amp;theme=143fee85a851ed0c66a883de\u0026amp;signature=d4efb6352d2196a6ae937dee96997442350a061b3b82444f03b703ff9ec3dfb3\">\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=\"IP → Mobile Device IDs - Retention.com Enrichment\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find the mobile advertising IDs seen at an IP address. Provide an IPv4 or IPv6 ip_address. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address. Billing: 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://retention.mintlify.app/_mintlify/api/og/v2?division=Identity+Resolution\u0026amp;title=IP+%E2%86%92+Mobile+Device+IDs\u0026amp;description=Find+the+mobile+advertising+IDs+seen+at+an+IP+address.%0A%0AProvide+an+IPv4+or+IPv6+%60ip_address%60.+We+use+our+proprietary+identity+resolution+technology+to+return+th\u0026amp;theme=143fee85a851ed0c66a883de\u0026amp;signature=d4efb6352d2196a6ae937dee96997442350a061b3b82444f03b703ff9ec3dfb3\">\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/retention/npq8Vd2x9SJbcBOC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Retention.com Enrichment\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111827\">\u003clink data-mint-head rel=\"canonical\" href=\"https://retention.mintlify.app/api-reference/ip/ip-to-maid\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ip/ip-to-maid.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://retention.mintlify.app/#organization\",\"name\":\"Retention.com Enrichment\",\"url\":\"https://retention.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/retention/egMTYLJ50XLFHYE0/logo/logo.png?fit=max\u0026auto=format\u0026n=egMTYLJ50XLFHYE0\u0026q=85\u0026s=a4ab393f132873bd76647aa98d1e3239\"}},{\"@type\":\"WebSite\",\"@id\":\"https://retention.mintlify.app#website\",\"name\":\"Retention.com Enrichment\",\"url\":\"https://retention.mintlify.app\",\"publisher\":{\"@id\":\"https://retention.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid#webpage\",\"url\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid\",\"name\":\"IP → Mobile Device IDs\",\"description\":\"Find the mobile advertising IDs seen at an IP address. Provide an IPv4 or IPv6 ip_address. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address. Billing: 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.\",\"dateModified\":\"2026-10-30T17:06:46.504Z\",\"isPartOf\":{\"@id\":\"https://retention.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Identity Resolution\",\"item\":\"https://retention.mintlify.app/api-reference/ip/ip-to-hem\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"IP → Mobile Device IDs\",\"item\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid#apireference\",\"headline\":\"IP → Mobile Device IDs\",\"name\":\"IP → Mobile Device IDs\",\"description\":\"Find the mobile advertising IDs seen at an IP address. Provide an IPv4 or IPv6 ip_address. We use our proprietary identity resolution technology to return the mobile advertising IDs (MAIDs) recently observed at the IP address. Billing: 1 credit per successful lookup (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.\",\"url\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid\",\"mainEntityOfPage\":{\"@id\":\"https://retention.mintlify.app/api-reference/ip/ip-to-maid#webpage\"},\"dateModified\":\"2026-10-30T17:06:46.504Z\",\"publisher\":{\"@id\":\"https://retention.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://retention.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Retention.com Enrichment\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Retention.com Enrichment","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://ui.api.rb2b.com/dashboard"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"All APIs","icon":"rectangle-api","groups":[{"group":"Identity Enrichment","pages":[{"title":"Enrichment APIs","href":"/reference/introduction"},{"title":"Universal Identity","openapi":"POST /api/v1/identity/person","href":"/api-reference/identity/universal"},{"title":"Personal Identity","openapi":"POST /api/v1/identity/consumer","href":"/api-reference/identity/personal-identity-b2c"},{"title":"Full Business Enrichment","openapi":"POST /api/v1/identity/business","href":"/api-reference/identity/professional-identity-b2b"}]},{"group":"Email lookups","pages":[{"title":"Email → Mobile Device IDs","openapi":"POST /api/v1/hem_to_maid","href":"/api-reference/hem/hem-to-maid"},{"title":"Email → LinkedIn","openapi":"POST /api/v1/hem_to_linkedin","href":"/api-reference/hem/hem-to-linkedin"},{"title":"Email → Best LinkedIn","openapi":"POST /api/v1/hem_to_best_linkedin","href":"/api-reference/hem/hem-to-best-linkedin"},{"title":"Email → Business Profile","openapi":"POST /api/v1/hem_to_business_profile","href":"/api-reference/hem/hem-to-business-profile"}]},{"group":"Identity Resolution","pages":[{"title":"IP → Hashed Email","openapi":"POST /api/v1/ip_to_hem","description":"Resolve an IP (and browser details) into the visitor's hashed email.\n\nProvide an IPv4 or IPv6 `ip_address` (optionally with the visitor's `user_agent`). We use our proprietary identity resolution technology to derive and return up to 3 matches ordered by descending confidence score; set `include_sha256` to also return each match's SHA-256 hashed email.\n\n**Billing:** 1 credit per successful lookup (HTTP 200), regardless of how many matches are returned. Misses (404) and request errors (4xx) are not billed.","href":"/api-reference/ip/ip-to-hem"},{"title":"IP → Mobile Device IDs","openapi":"POST /api/v1/ip_to_maid","href":"/api-reference/ip/ip-to-maid"},{"title":"IP → Company","openapi":"POST /api/v1/ip_to_company","description":"Identify the company or organization behind an IP address.\n\nProvide an IPv4 or IPv6 `ip_address`. Returns the candidate company domains with their match percentages. When no traffic-share breakdown is available, one domain is returned with `percentage` `\"1.0\"`.\n\n**Billing:** 1 credit per successful lookup (HTTP 200), regardless of how many companies are returned. Misses (404) and request errors (4xx) are not billed.","href":"/api-reference/ip/ip-to-company"},{"title":"IP → Business Profile","openapi":"POST /api/v1/ip_to_business_profile","href":"/api-reference/ip/ip-to-business-profile"}]},{"group":"LinkedIn lookups","pages":[{"title":"LinkedIn → Hashed Emails","openapi":"POST /api/v1/linkedin_to_hashed_emails","href":"/api-reference/linkedin/linkedin-to-hashed-emails"},{"title":"LinkedIn → Mobile Phone","openapi":"POST /api/v1/linkedin_to_mobile_phone","href":"/api-reference/linkedin/linkedin-to-mobile-phone"},{"title":"LinkedIn → Business Profile","openapi":"POST /api/v1/linkedin_to_business_profile","href":"/api-reference/linkedin/linkedin-to-business-profile"},{"title":"LinkedIn → Business Email","openapi":"POST /api/v1/linkedin_to_business_email","href":"/api-reference/linkedin/linkedin-to-business-email"}]},{"group":"Search, activity \u0026 account","pages":[{"title":"Find LinkedIn Profile","openapi":"POST /api/v1/linkedin_slug_search","href":"/api-reference/other/linkedin-slug-search"},{"title":"Work Email → Personal Email","openapi":"POST /api/v1/business_email_to_personal_hem","href":"/api-reference/other/business-email-to-personal-hem"},{"title":"Email Activity Check","openapi":"POST /api/v1/email_to_activity","href":"/api-reference/other/email-to-activity"},{"title":"Credits","openapi":"GET /api/v1/credits","href":"/api-reference/other/credits"}]}]}]},"basePath":"","title":"IP → Mobile Device IDs - Retention.com Enrichment","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}