Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email.
Provide either a pre-computed md5 (32-character hex digest of the lowercased, trimmed email) or a plaintext email. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type.
Billing: 1 credit per successful match (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.
One entry per mobile advertising ID linked to the hashed email.
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/hem/hem-to-maid","slug":"/api-reference/hem/hem-to-maid","pageMetadata":{"title":"Email → Mobile Device IDs","openapi":"POST /api/v1/hem_to_maid","description":"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email.\n\nProvide either a pre-computed `md5` (32-character hex digest of the lowercased, trimmed email) or a plaintext `email`. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type.\n\n**Billing:** 1 credit per successful match (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.","href":"/api-reference/hem/hem-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 linked to an email. Accepts a hashed or plaintext email.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Provide either a pre-computed \", _jsx(_components.code, {\n children: \"md5\"\n }), \" (32-character hex digest of the lowercased, trimmed email) or a plaintext \", _jsx(_components.code, {\n children: \"email\"\n }), \". Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Billing:\"\n }), \" 1 credit per successful match (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":"Email → Mobile Device IDs","openapi":"POST /api/v1/hem_to_maid","description":"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email.\n\nProvide either a pre-computed `md5` (32-character hex digest of the lowercased, trimmed email) or a plaintext `email`. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type.\n\n**Billing:** 1 credit per successful match (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.","href":"/api-reference/hem/hem-to-maid"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Email → Mobile Device IDs","tags":["HEM"],"operationId":"hemToMaid","description":"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email.\n\nProvide either a pre-computed `md5` (32-character hex digest of the lowercased, trimmed email) or a plaintext `email`. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type.\n\n**Billing:** 1 credit per successful match (HTTP 200), regardless of how many device IDs are returned. Misses (404) and request errors (4xx) are not billed.","security":["237dddb5-361d-452e-8bef-cdbbe7d28167"],"parameters":[],"responses":{"200":"c388175f-c416-4de8-9721-7e1a4ae6ecc8","400":"9e016d0d-5694-40dd-b46a-f2519f64ec18","401":"2a203d1b-9638-4b73-9ac8-9ef9363ab08a","402":"d698b8e7-8aef-42b7-b3a4-d76fd7d02d28","403":"1b62f3fc-ea6d-4632-b3ed-0d2b9755eb83","404":"c1f0b508-fbc6-4fbc-b256-b0bb4c25f250"},"requestBody":"791538ea-5808-4ab6-a6b3-9f1b595559a1","method":"post","type":"path","servers":["aa17081d-9c74-404e-b17f-a02fb504f21f"],"path":"/api/v1/hem_to_maid","baseUrlOptions":["https://api.rb2b.com"],"title":"Email → Mobile Device IDs","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"At least one of `md5` or `email` is required.","properties":{"md5":{"type":"string","pattern":"^[a-fA-F0-9]{32}$","description":"MD5 hash of the lowercased, trimmed email address.","example":"5d41402abc4b2a76b9719d911017c592","uniqueKey":"md5","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Plaintext email address. Used only when `md5` is absent.","example":"alice@example.com","uniqueKey":"email","typeLabel":"string\u003cemail>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"md5":"5d41402abc4b2a76b9719d911017c592","email":"alice@example.com"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"c388175f-c416-4de8-9721-7e1a4ae6ecc8":{"description":"MAIDs found (1 credit charged)","content":{"application/json":{"schema":{"type":"object","required":["results"],"properties":{"results":{"type":"array","description":"One entry per mobile advertising ID linked to the hashed email.","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"},"9e016d0d-5694-40dd-b46a-f2519f64ec18":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["missing md5_or_email","invalid md5","unexpected connection error","unexpected error"],"description":"`missing md5_or_email`: neither `md5` nor `email` was provided. `invalid md5`: the MD5 is not a 32-character hex digest. `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 md5_or_email"}}},"exampleType":"generated"}},"exampleType":"generated"},"2a203d1b-9638-4b73-9ac8-9ef9363ab08a":{"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"},"d698b8e7-8aef-42b7-b3a4-d76fd7d02d28":{"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"},"1b62f3fc-ea6d-4632-b3ed-0d2b9755eb83":{"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"},"c1f0b508-fbc6-4fbc-b256-b0bb4c25f250":{"description":"No device IDs found (not billed)","content":{"application/json":{"schema":{"type":"object","required":["results"],"properties":{"results":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"results.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"`null` (or an empty array); no device IDs matched the supplied hashed email.","isRequired":true,"uniqueKey":"results.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"description":"`null` (or an empty array); no device IDs matched the supplied hashed email.","isRequired":true,"uniqueKey":"results.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results","typeLabel":"object[] | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"237dddb5-361d-452e-8bef-cdbbe7d28167":{"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":"Email → Mobile Device IDs - Retention.com Enrichment","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T17:06:46.504Z","originalFileLocation":"api-reference/hem/hem-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 linked to an email. Accepts a hashed or plaintext email. Provide either a pre-computed md5 (32-character hex digest of the lowercased, trimmed email) or a plaintext email. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type. Billing: 1 credit per successful match (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=\"Email → Mobile Device IDs - Retention.com Enrichment\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email. Provide either a pre-computed md5 (32-character hex digest of the lowercased, trimmed email) or a plaintext email. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type. Billing: 1 credit per successful match (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/hem/hem-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=Email+lookups\u0026amp;title=Email+%E2%86%92+Mobile+Device+IDs\u0026amp;description=Find+the+mobile+advertising+IDs+linked+to+an+email.+Accepts+a+hashed+or+plaintext+email.%0A%0AProvide+either+a+pre-computed+%60md5%60+%2832-character+hex+digest+of+the+lo\u0026amp;theme=143fee85a851ed0c66a883de\u0026amp;signature=51f8492f98c643c069532dac7f44109ee9ec4531ca7f510521a49b0b11005e8e\">\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=\"Email → Mobile Device IDs - Retention.com Enrichment\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email. Provide either a pre-computed md5 (32-character hex digest of the lowercased, trimmed email) or a plaintext email. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type. Billing: 1 credit per successful match (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=Email+lookups\u0026amp;title=Email+%E2%86%92+Mobile+Device+IDs\u0026amp;description=Find+the+mobile+advertising+IDs+linked+to+an+email.+Accepts+a+hashed+or+plaintext+email.%0A%0AProvide+either+a+pre-computed+%60md5%60+%2832-character+hex+digest+of+the+lo\u0026amp;theme=143fee85a851ed0c66a883de\u0026amp;signature=51f8492f98c643c069532dac7f44109ee9ec4531ca7f510521a49b0b11005e8e\">\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/hem/hem-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/hem/hem-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/hem/hem-to-maid#webpage\",\"url\":\"https://retention.mintlify.app/api-reference/hem/hem-to-maid\",\"name\":\"Email → Mobile Device IDs\",\"description\":\"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email. Provide either a pre-computed md5 (32-character hex digest of the lowercased, trimmed email) or a plaintext email. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type. Billing: 1 credit per successful match (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/hem/hem-to-maid#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://retention.mintlify.app/api-reference/hem/hem-to-maid#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Retention.com Enrichment\",\"item\":\"https://retention.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Email → Mobile Device IDs\",\"item\":\"https://retention.mintlify.app/api-reference/hem/hem-to-maid\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://retention.mintlify.app/api-reference/hem/hem-to-maid#apireference\",\"headline\":\"Email → Mobile Device IDs\",\"name\":\"Email → Mobile Device IDs\",\"description\":\"Find the mobile advertising IDs linked to an email. Accepts a hashed or plaintext email. Provide either a pre-computed md5 (32-character hex digest of the lowercased, trimmed email) or a plaintext email. Returns every mobile advertising ID (MAID) linked to the hashed email, each with its device type. Billing: 1 credit per successful match (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/hem/hem-to-maid\",\"mainEntityOfPage\":{\"@id\":\"https://retention.mintlify.app/api-reference/hem/hem-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","description":"One call returns everything for a contact: work profile, device IDs, hashed emails. Send a hashed or plaintext email, an IP address, or a batch of up to 1,000 values.\n\nSingle mode: provide a pre-computed `md5`, a plaintext `email`, or an IPv4 or IPv6 `ip_address` with an optional `user_agent`. USA IPs only! Choose exactly one identifier family. The response combines the business profile (same field names as `/hem_to_business_profile`) with the contact's mobile advertising IDs. `work_email_confirmed` is always plaintext, with `work_email_confirmed_md5` and `work_email_confirmed_sha256` alongside so callers have all three forms; no personal email data is returned. The `maid` key is always present (`null` when no MAID data is found), and when the profile lookup misses but MAID data exists the full profile shape is still returned with `null` values. A match returns HTTP 200 `{ result: {...} }`; a miss returns HTTP 404 `{ result: {} }`.\n\nBatch mode: send an `md5s` or `ips` array (max 1,000). MD5s are lowercased and de-duplicated; equivalent IP spellings are de-duplicated while preserving the first input. One malformed MD5 fails the whole request with HTTP 400 before any lookups run. Otherwise the response is always HTTP 200 with `results`, `match_count`, `credits_charged`, and `credits_exhausted`. Every matched result returns `md5`; IP batch results also echo `ip_address`. Inputs with no data are omitted. Processing stops once the account's remaining credits are exhausted (`credits_exhausted: true`).\n\n**Billing:** the full configured per-record cost when both the business profile and MAID data match; 1 credit when only one of the two sources resolves (partial data); 0 credits for a miss (single-mode 404, or omitted from batch `results`). IP-sourced matches add 1 credit (full 4, partial 2 at the default price). Request errors (4xx) are not billed.","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","description":"Find the LinkedIn profile that belongs to an email. Accepts a hashed or plaintext email.\n\nProvide either a pre-computed `md5` (32-character hex digest of the lowercased, trimmed email) or a plaintext `email`. Returns the LinkedIn public profile slug matched to the hashed email.\n\n**Billing:** 1 credit per successful match (HTTP 200). Misses (404) and request errors (4xx) are not billed.","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","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","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":"Email → 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"]}