Poll the status of a previously submitted bulk enrichment batch. The response uses the same envelope shape as single-request polling and webhooks, with multiple items in the data array. Track progress by comparing completed_count to total.
Path parameters
string
required
The batch ID returned by POST /api/v1/email/bulk.
Header parameters
string
required
Bearer <your_api_key>
string
Optional alternative to the Authorization Bearer scheme. Your API key sent as a header.
Request example
curl -X GET "https://ext-api.dmand.ai/api/v1/batch/b_456" \ -H "Authorization: Bearer YOUR_API_KEY"
There is no pagination on this endpoint. The data array contains all requests in the batch.
Compare completed_count to total to know when the entire batch is done.
Use webhooks as your primary notification mechanism and poll only as a fallback if a webhook does not arrive.
Dedupe updates by request_id so replays and retries do not create duplicate records in your system.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dmand AI APIs","colors":{"primary":"#167171","light":"#5BACAB","dark":"#069494"},"logo":{"light":"https://mintcdn.com/dmand/uHL6asBXoEARnrrN/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=uHL6asBXoEARnrrN\u0026q=85\u0026s=ba4ace8577e8df7ba4948c7e49830602","dark":"https://mintcdn.com/dmand/uHL6asBXoEARnrrN/images/logo-light.svg?fit=max\u0026auto=format\u0026n=uHL6asBXoEARnrrN\u0026q=85\u0026s=41b8b6abd2c939b47a637391ce490671","href":"https://dmand.ai"},"favicon":{"light":"https://mintcdn.com/dmand/whN-hxCZp87cG25j/images/logo-mark-dark.svg?fit=max\u0026auto=format\u0026n=whN-hxCZp87cG25j\u0026q=85\u0026s=3ae7dd3ceeeae84c490d9d2f485cfbe3","dark":"https://mintcdn.com/dmand/whN-hxCZp87cG25j/images/logo-mark.svg?fit=max\u0026auto=format\u0026n=whN-hxCZp87cG25j\u0026q=85\u0026s=9d0460fd5dd9800320fd5c02b97e3c71"},"api":{"mdx":{"auth":{"method":"bearer"},"server":"https://ext-api.dmand.ai"}},"appearance":{"default":"dark"},"background":{"decoration":"windows"},"navbar":{"links":[{"href":"mailto:hello@dmand.ai","label":"Help"}],"primary":{"type":"button","label":"Website","href":"https://dmand.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/dmandai","website":"https://www.dmand.ai","x":"https://x.com/dmandhq"}},"fonts":{"heading":{"family":"Archivo","weight":600},"body":{"family":"Geist","weight":400}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"variables":{"API-URL":"https://ext-api.dmand.ai","CONTACT-EMAIL":"hello@dmand.ai","STALE-PERIOD":"30","BUILK-BATCH-SIZE":"45","API-KEY-HEADER-NAME":"X-API-Key","DMAND-APP-URL":"https://app.dmand.ai/","PERSONAL-EMAIL-CREDIT":"3","PROFESSIONAL-EMAIL-CREDIT":"1","ANY-EMAIL-CREDIT":"1","LIVE-ENRICH-TIMEOUT":"5-10","API-REQUEST-EMAIL-REQUEST":"subject=Dmand%20API%20Key%20Assistance%20%E2%80%94%20New%20Key%20or%20Rotation%20Request\u0026body=Hi%20Dmand%20AI%20Team%20%F0%9F%91%8B%0A%0AI%E2%80%99m%20reaching%20out%20for%20assistance%20with%20my%20Dmand%20API%20key.%0A%0AI%E2%80%99d%20like%20help%20with%20one%20of%20the%20following%3A%0A%0A%F0%9F%94%91%20Request%20a%20new%20API%20key%0A%E2%99%BB%EF%B8%8F%20Rotate%20my%20existing%20API%20key%0A%0AHere%20are%20my%20details%3A%0A%0A%E2%80%A2%20Name%3A%20%5BYour%20Name%5D%0A%E2%80%A2%20Email%3A%20%5BYour%20Email%5D%0A%E2%80%A2%20Project%20%2F%20Application%3A%20%5BProject%20Name%5D%0A%0APlease%20let%20me%20know%20which%20information%20you%20need%20from%20me%20to%20proceed.%20I%E2%80%99ll%20be%20happy%20to%20provide%20any%20additional%20details%20required.%0A%0AThanks%20for%20your%20help%21%20%F0%9F%99%8C%0A%0ABest%2C%0A%5BYour%20Name%5D","RATE-LIMIT-NPIS":"45"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://dmand.ai"},{"anchor":"Pricing","icon":"tag","href":"https://dmand.ai/pricing"},{"anchor":"Contact Us","icon":"calendar","href":"https://dmand.ai/book-meeting"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dmand","hasAudioNarration":false,"actualSubdomain":"dmand","customDomains":["docs.dmand.ai"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-dmand-c27ab419","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae21c508ffbca586928f2c0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":5},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Core Concepts","count":3},{"language":"default","tag":"Integrations","count":2}]},"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":"custom-rbac-roles","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":"rbac-expansion","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":"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":"site-roles","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/email/get-batch","slug":"/api-reference/email/get-batch","pageMetadata":{"title":"Get Bulk Email Enrichment Status and Results","sidebarTitle":"GET /batch/{batch_id}","description":"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.","api":"GET /api/v1/batch/{batch_id}","authMethod":"bearer","href":"/api-reference/email/get-batch"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"GET /api/v1/batch/\", \" polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,ParamField,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Poll the status of a previously submitted bulk enrichment batch. The response uses the same envelope shape as single-request polling and webhooks, with multiple items in the `,_jsx(_components.code,{children:`data`}),` array. Track progress by comparing `,_jsx(_components.code,{children:`completed_count`}),` to `,_jsx(_components.code,{children:`total`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`batch_id`,type:`string`,required:true,id:`param-batch-id`,children:_jsxs(_components.p,{children:[`The batch ID returned by `,_jsx(_components.code,{children:`POST /api/v1/email/bulk`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`header-parameters`,children:`Header parameters`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`Bearer \u003cyour_api_key>`})})}),`\n`,_jsx(ParamField,{header:`X-API-Key`,type:`string`,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Optional alternative to the Authorization Bearer scheme. Your API key sent as a header.`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-example`,children:`Request example`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://ext-api.dmand.ai/api/v1/batch/b_456\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`7`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://ext-api.dmand.ai/api/v1/batch/b_456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.json())`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`5`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://ext-api.dmand.ai/api/v1/batch/b_456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`batch`,type:`object`,required:true,id:`param-batch`,children:[_jsx(_components.p,{children:`Batch metadata.`}),_jsxs(Expandable,{title:`batch fields`,children:[_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`Batch identifier.`})}),_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`Overall batch status: `,_jsx(_components.code,{children:`in-progress`}),` or `,_jsx(_components.code,{children:`completed`}),`.`]})}),_jsx(ResponseField,{name:`total`,type:`integer`,required:true,id:`param-total`,children:_jsx(_components.p,{children:`Total number of requests in the batch.`})}),_jsx(ResponseField,{name:`completed_count`,type:`integer`,required:true,id:`param-completed-count`,children:_jsx(_components.p,{children:`Number of requests that have finished.`})}),_jsx(ResponseField,{name:`created_at`,type:`string | null`,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp when the batch was created.`})}),_jsx(ResponseField,{name:`updated_at`,type:`string | null`,id:`param-updated-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp when the batch was last updated.`})})]})]}),`\n`,_jsxs(ResponseField,{name:`webhook`,type:`object | null`,id:`param-webhook`,children:[_jsxs(_components.p,{children:[`Webhook configuration and delivery status. `,_jsx(_components.code,{children:`null`}),` when no webhook was provided at submission.`]}),_jsxs(Expandable,{title:`webhook fields`,children:[_jsx(ResponseField,{name:`url`,type:`string | null`,id:`param-url`,children:_jsx(_components.p,{children:`The callback URL.`})}),_jsx(ResponseField,{name:`mode`,type:`string | null`,id:`param-mode`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`real-time`}),` or `,_jsx(_components.code,{children:`batch`}),`.`]})}),_jsx(ResponseField,{name:`status`,type:`string | null`,id:`param-status-1`,children:_jsxs(_components.p,{children:[`Webhook delivery status: `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`delivered`}),`, `,_jsx(_components.code,{children:`failed`}),`, or `,_jsx(_components.code,{children:`none`}),`.`]})})]})]}),`\n`,_jsx(ResponseField,{name:`custom_data`,type:`object | null`,id:`param-custom-data`,children:_jsx(_components.p,{children:`The exact JSON object you provided in the submission request.`})}),`\n`,_jsxs(ResponseField,{name:`usage`,type:`object | null`,id:`param-usage`,children:[_jsx(_components.p,{children:`Credit usage for this response.`}),_jsxs(Expandable,{title:`usage fields`,children:[_jsx(ResponseField,{name:`credits_used`,type:`number | null`,id:`param-credits-used`,children:_jsx(_components.p,{children:`Credits consumed for this batch.`})}),_jsx(ResponseField,{name:`balance`,type:`number | null`,id:`param-balance`,children:_jsx(_components.p,{children:`Remaining credit balance after this batch.`})})]})]}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object[]`,required:true,id:`param-data`,children:[_jsx(_components.p,{children:`Array of per-request results for every NPI in the batch.`}),_jsxs(Expandable,{title:`data item fields`,children:[_jsx(ResponseField,{name:`request_id`,type:`string`,required:true,id:`param-request-id`,children:_jsx(_components.p,{children:`Unique request identifier.`})}),_jsx(ResponseField,{name:`npi`,type:`string`,required:true,id:`param-npi`,children:_jsx(_components.p,{children:`The submitted 10-digit NPI.`})}),_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status-2`,children:_jsx(_components.p,{children:`Request status. See status values below.`})}),_jsx(ResponseField,{name:`replayed`,type:`boolean`,default:`false`,id:`param-replayed`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when this result is a free replay within `,_jsx(_components.code,{children:`30`}),` days for the same organization and NPI.`]})}),_jsx(ResponseField,{name:`email_type`,type:`string | null`,id:`param-email-type`,children:_jsxs(_components.p,{children:[`Type of email found. Example values include `,_jsx(_components.code,{children:`personal`}),` and `,_jsx(_components.code,{children:`professional`}),`.`]})}),_jsx(ResponseField,{name:`email`,type:`string | null`,id:`param-email`,children:_jsx(_components.p,{children:`The enriched email address, if found.`})}),_jsx(ResponseField,{name:`email_last_validated`,type:`string | null`,id:`param-email-last-validated`,children:_jsx(_components.p,{children:`ISO 8601 date when the email was last validated.`})}),_jsx(ResponseField,{name:`email_status`,type:`string | null`,id:`param-email-status`,children:_jsxs(_components.p,{children:[`Validation status of the email. `,_jsx(_components.code,{children:`valid`}),` when an email is returned, otherwise `,_jsx(_components.code,{children:`null`}),`.`]})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`status-values`,children:`Status values`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`accepted`})}),_jsx(_components.td,{children:`The request was received and is queued for processing.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`in-progress`})}),_jsx(_components.td,{children:`The request is still being resolved.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completed`})}),_jsx(_components.td,{children:`An email was found and the email fields are populated.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`not_found`})}),_jsx(_components.td,{children:`No email was found. No credits are charged.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsxs(_components.td,{children:[`The request could not finish within about `,_jsx(_components.code,{children:`5-10`}),` minutes. Credits are refunded.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`example-response`,children:`Example response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`54`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`54`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"batch\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b_456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"in-progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completed_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-28T10:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-28T10:05:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webhook\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/hooks/dmand\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"batch\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"custom_data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"campaign\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"q3-outreach\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits_used\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"balance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`999`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"r_789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"npi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1003158791\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"replayed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"professional\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane.doe@examplehealth.org\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_last_validated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-20T00:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"valid\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"r_790\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"npi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"not_found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"replayed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_last_validated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"r_791\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"npi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9876543210\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"in-progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"replayed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_last_validated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Missing or invalid API keys are rejected.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`403`}),`: Revoked or inactive API key.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`422`}),`: Validation error, with a response body like:`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"loc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"batch_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"msg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Field required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"missing\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`tips`,children:`Tips`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`There is no pagination on this endpoint. The `,_jsx(_components.code,{children:`data`}),` array contains all requests in the batch.`]}),`\n`,_jsxs(_components.li,{children:[`Compare `,_jsx(_components.code,{children:`completed_count`}),` to `,_jsx(_components.code,{children:`total`}),` to know when the entire batch is done.`]}),`\n`,_jsx(_components.li,{children:`Use webhooks as your primary notification mechanism and poll only as a fallback if a webhook does not arrive.`}),`\n`,_jsxs(_components.li,{children:[`Dedupe updates by `,_jsx(_components.code,{children:`request_id`}),` so replays and retries do not create duplicate records in your system.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Bulk Email Enrichment Status and Results","sidebarTitle":"GET /batch/{batch_id}","description":"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.","api":"GET /api/v1/batch/{batch_id}","authMethod":"bearer","href":"/api-reference/email/get-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Header parameters","slug":"header-parameters","depth":2,"children":[]},{"title":"Request example","slug":"request-example","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Status values","slug":"status-values","depth":3,"children":[]},{"title":"Example response","slug":"example-response","depth":3,"children":[]}]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Tips","slug":"tips","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Get Bulk Email Enrichment Status and Results","path":"/api/v1/batch/{batch_id}","servers":[{"url":"https://ext-api.dmand.ai"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{"Authorization":{"schema":[{"type":"string","description":"`Bearer \u003cyour_api_key>`","required":true}]},"X-API-Key":{"schema":[{"type":"string","description":"Optional alternative to the Authorization Bearer scheme. Your API key sent as a header."}]}},"cookie":{},"path":{"batch_id":{"schema":[{"type":"string","description":"The batch ID returned by `POST /api/v1/email/bulk` .","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"batch":[{"type":"object","properties":{"id":[{"type":"string","description":"Batch identifier.","required":true}],"status":[{"type":"string","description":"Overall batch status: `in-progress` or `completed` .","required":true}],"total":[{"type":"integer","description":"Total number of requests in the batch.","required":true}],"completed_count":[{"type":"integer","description":"Number of requests that have finished.","required":true}],"created_at":[{"type":"object","properties":{},"description":"ISO 8601 timestamp when the batch was created."}],"updated_at":[{"type":"object","properties":{},"description":"ISO 8601 timestamp when the batch was last updated."}]},"description":"Batch metadata.","required":true}],"webhook":[{"type":"object","properties":{"url":[{"type":"object","properties":{},"description":"The callback URL."}],"mode":[{"type":"object","properties":{},"description":"`real-time` or `batch` ."}],"status":[{"type":"object","properties":{},"description":"Webhook delivery status: `pending` , `delivered` , `failed` , or `none` ."}]},"description":"Webhook configuration and delivery status. `null` when no webhook was provided at submission."}],"custom_data":[{"type":"object","properties":{},"description":"The exact JSON object you provided in the submission request."}],"usage":[{"type":"object","properties":{"credits_used":[{"type":"object","properties":{},"description":"Credits consumed for this batch."}],"balance":[{"type":"object","properties":{},"description":"Remaining credit balance after this batch."}]},"description":"Credit usage for this response."}],"data":[{"type":"array","items":[{"type":"object","properties":{"request_id":[{"type":"string","description":"Unique request identifier.","required":true}],"npi":[{"type":"string","description":"The submitted 10-digit NPI.","required":true}],"status":[{"type":"string","description":"Request status. See status values below.","required":true}],"replayed":[{"type":"boolean","description":"`true` when this result is a free replay within `30` days for the same organization and NPI."}],"email_type":[{"type":"object","properties":{},"description":"Type of email found. Example values include `personal` and `professional` ."}],"email":[{"type":"object","properties":{},"description":"The enriched email address, if found."}],"email_last_validated":[{"type":"object","properties":{},"description":"ISO 8601 date when the email was last validated."}],"email_status":[{"type":"object","properties":{},"description":"Validation status of the email. `valid` when an email is returned, otherwise `null` ."}]}}],"description":"Array of per-request results for every NPI in the batch.","required":true}]}}],"examples":{"example":{"value":{"batch":{"id":"\u003cstring>","status":"\u003cstring>","total":123,"completed_count":123,"created_at":{},"updated_at":{}},"webhook":{"url":{},"mode":{},"status":{}},"custom_data":{},"usage":{"credits_used":{},"balance":{}},"data":[{"request_id":"\u003cstring>","npi":"\u003cstring>","status":"\u003cstring>","replayed":true,"email_type":{},"email":{},"email_last_validated":{},"email_status":{}}]}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"dmand","siteName":"Dmand AI APIs","title":"Get Bulk Email Enrichment Status and Results - Dmand AI APIs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T12:51:39.341Z","originalFileLocation":"api-reference/email/get-batch.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=\"dark\"}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=\"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dmand AI APIs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_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/dmand/k9f9N_Dm1Hegfg6m/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Bulk Email Enrichment Status and Results - Dmand AI APIs\">\u003cmeta data-mint-head property=\"og:description\" content=\"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dmand AI APIs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dmand.ai/api-reference/email/get-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dmand.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+Bulk+Email+Enrichment+Status+and+Results\u0026amp;description=GET+%2Fapi%2Fv1%2Fbatch%2F%7Bbatch_id%7D+polls+a+bulk+enrichment+batch.+Returns+the+response+envelope+with+per-request+results%2C+progress%2C+and+usage.\u0026amp;theme=9c130034ade83db7b85e0009\u0026amp;signature=d635656dca3247205f078d8a104e116658eefe135aabe214208ea823312d3271\">\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=\"Get Bulk Email Enrichment Status and Results - Dmand AI APIs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dmand.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+Bulk+Email+Enrichment+Status+and+Results\u0026amp;description=GET+%2Fapi%2Fv1%2Fbatch%2F%7Bbatch_id%7D+polls+a+bulk+enrichment+batch.+Returns+the+response+envelope+with+per-request+results%2C+progress%2C+and+usage.\u0026amp;theme=9c130034ade83db7b85e0009\u0026amp;signature=d635656dca3247205f078d8a104e116658eefe135aabe214208ea823312d3271\">\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/dmand/k9f9N_Dm1Hegfg6m/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dmand AI APIs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#167171\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dmand.ai/api-reference/email/get-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/email/get-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dmand.ai/#organization\",\"name\":\"Dmand AI APIs\",\"url\":\"https://docs.dmand.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dmand/uHL6asBXoEARnrrN/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=uHL6asBXoEARnrrN\u0026q=85\u0026s=ba4ace8577e8df7ba4948c7e49830602\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dmand.ai#website\",\"name\":\"Dmand AI APIs\",\"url\":\"https://docs.dmand.ai\",\"publisher\":{\"@id\":\"https://docs.dmand.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dmand.ai/api-reference/email/get-batch#webpage\",\"url\":\"https://docs.dmand.ai/api-reference/email/get-batch\",\"name\":\"Get Bulk Email Enrichment Status and Results\",\"description\":\"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.\",\"dateModified\":\"2026-09-28T12:51:39.341Z\",\"isPartOf\":{\"@id\":\"https://docs.dmand.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dmand.ai/api-reference/email/get-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dmand.ai/api-reference/email/get-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.dmand.ai/api-reference/email/submit\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Bulk Email Enrichment Status and Results\",\"item\":\"https://docs.dmand.ai/api-reference/email/get-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dmand.ai/api-reference/email/get-batch#apireference\",\"headline\":\"Get Bulk Email Enrichment Status and Results\",\"name\":\"Get Bulk Email Enrichment Status and Results\",\"description\":\"GET /api/v1/batch/{batch_id} polls a bulk enrichment batch. Returns the response envelope with per-request results, progress, and usage.\",\"url\":\"https://docs.dmand.ai/api-reference/email/get-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dmand.ai/api-reference/email/get-batch#webpage\"},\"dateModified\":\"2026-09-28T12:51:39.341Z\",\"publisher\":{\"@id\":\"https://docs.dmand.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dmand.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dmand AI APIs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dmand AI APIs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/email/get-batch.md","siteName":"Dmand AI APIs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://dmand.ai"},{"anchor":"Pricing","icon":"tag","href":"https://dmand.ai/pricing"},{"anchor":"Contact Us","icon":"calendar","href":"https://dmand.ai/book-meeting"}]},"groups":[{"group":"Getting Started","pages":[{"title":"Dmand AI API: Verified Healthcare Provider Emails by NPI","sidebarTitle":"API Overview","href":"/index"},{"title":"Get Started with the Dmand AI API in Four Steps","sidebarTitle":"Quickstart","href":"/quickstart"},{"title":"Authenticate Dmand AI API Requests with Your API Key","sidebarTitle":"Authentication","href":"/general/authentication"},{"title":"How Dmand AI Webhooks Deliver Enrichment Results","sidebarTitle":"Webhooks","href":"/general/webhooks"},{"title":"Dmand AI API Rate Limits and Throughput Guidelines","sidebarTitle":"Rate Limits","href":"/general/rate-limits"}]},{"group":"Core Concepts","pages":[{"title":"How Dmand AI API Credits Are Held, Charged, and Refunded","sidebarTitle":"Credits","href":"/general/credits"},{"title":"Enrichment Request Statuses, Email Fields, and Freshness","sidebarTitle":"Statuses","href":"/general/contact-status"},{"title":"Dmand AI API Data Dictionary: Request and Response Fields","sidebarTitle":"Data Dictionary","href":"/general/data-dictionary"}]},{"group":"Integrations","pages":[{"title":"Dmand AI Email Enrichment Requests","sidebarTitle":"Requests","href":"/implement-in-product/getting-started"},{"title":"Scale Dmand AI Enrichment with Batching and Rate Limits","sidebarTitle":"Volume","href":"/implement-in-product/volume"}]},{"group":"API Reference","pages":[{"title":"Submit a Single NPI for Email Enrichment via Dmand AI","sidebarTitle":"POST /email","api":"POST /api/v1/email","href":"/api-reference/email/submit"},{"title":"Submit Bulk NPIs for Email Enrichment via Dmand AI","sidebarTitle":"POST /email/bulk","api":"POST /api/v1/email/bulk","href":"/api-reference/email/submit-bulk"},{"title":"Get Single Email Request Status and Enrichment Result","sidebarTitle":"GET /email/{request_id}","description":"GET /api/v1/email/{request_id} polls a single enrichment request. Returns batch metadata, webhook, usage, and email result fields.","api":"GET /api/v1/email/{request_id}","href":"/api-reference/email/get-request"},{"title":"Get Bulk Email Enrichment Status and Results","sidebarTitle":"GET /batch/{batch_id}","api":"GET /api/v1/batch/{batch_id}","href":"/api-reference/email/get-batch"},{"title":"Check Organization Credit Balance via Dmand AI API","sidebarTitle":"GET /credits","description":"GET /api/v1/credits returns the organization's credit balance, total, and used credits for the authenticated API key.","api":"GET /api/v1/credits","href":"/api-reference/account/credits"}]}]},"basePath":"","title":"Get Bulk Email Enrichment Status and Results - Dmand AI APIs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}