{
"error": "File is still being processed",
"file_status": "processing",
"progress_percentage": 75
}
Download Results
Download Clean List
Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.
GET
/
v1
/
api
/
cleanedemail
/
download-cleaned-emails
/
Download Clean Email List
curl --request GET \
--url https://base.sanitizeemail.com/v1/api/cleanedemail/download-cleaned-emails/ \
--header 'X-API-KEY: <api-key>'
{
"error": "File is still being processed",
"file_status": "processing",
"progress_percentage": 75
}
This endpoint generates and provides a download URL for the cleaned email list from a processed file. Use this to download a CSV file containing only the valid emails that passed the cleaning process.
Required Steps: 1. Upload file using File
Upload 2. Clean file using Clean Email
List 3. Wait for cleaning to complete
(status = “cleaned”) 4. Use this endpoint to get download URL
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sanitize Email API Docs","colors":{"primary":"#7f56d9","light":"#7f56d9","dark":"#7f56d9"},"logo":{"light":"https://mintcdn.com/sanitizeemail/FMqKL5b2i6-mwdGF/logo/light.svg?fit=max\u0026auto=format\u0026n=FMqKL5b2i6-mwdGF\u0026q=85\u0026s=46346baef74643b10ebb614be40687b2","dark":"https://mintcdn.com/sanitizeemail/FMqKL5b2i6-mwdGF/logo/dark.svg?fit=max\u0026auto=format\u0026n=FMqKL5b2i6-mwdGF\u0026q=85\u0026s=f543e50a0ef69e0fd7a3f9b7a924656e"},"favicon":"/favicon.svg","navbar":{"links":[{"label":"Support","href":"mailto:support@sanitizeemail.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.sanitizeemail.com/"}},"footer":{"socials":{"x":"https://x.com/sanitizeemailX","linkedin":"https://www.linkedin.com/company/sanitizeemail","instagram":"https://www.instagram.com/sanitizeemail","youtube":"https://www.youtube.com/@SanitizeEmail","facebook":"https://www.facebook.com/sanitizeemail"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sanitizeemail","hasAudioNarration":false,"actualSubdomain":"sanitizeemail","customDomains":["docs.sanitizeemail.com"],"gitSource":{"type":"github","owner":"vrittech","repo":"sanitize-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae92ac0ab814ccd6585676f:success","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Validation endpoints","count":3},{"language":"default","tag":"File endpoints","count":3},{"language":"default","tag":"Get Results","count":2},{"language":"default","tag":"Download Results","count":2},{"language":"default","tag":"Guides","count":2},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"API Documentation","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".dark select,.dark .select-field,[data-theme=\"dark\"] select{background-color:#0b0b0f!important;color:#f9fafb!important;border:1px solid #191922!important}.dark select option,[data-theme=\"dark\"] select option{background-color:#0b0b0f!important;border-radius:10px;color:#f9fafb!important}.dark select:focus,[data-theme=\"dark\"] select:focus{border-color:#7f56d9!important;box-shadow:0 0 0 1px #7f56d9!important}.dark .api-playground select,[data-theme=\"dark\"] .api-playground select{background-color:#111827!important;border-color:#4b5563!important}"}],"page":{"pagePath":"api-reference/endpoint/download_clean_list","slug":"/api-reference/endpoint/download_clean_list","pageMetadata":{"title":"Download Clean List","openapi":"GET /v1/api/cleanedemail/download-cleaned-emails/","description":"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.","href":"/api-reference/endpoint/download_clean_list","hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Note,Step,Steps,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This endpoint generates and provides a download URL for the cleaned email list from a processed file. Use this to download a CSV file containing only the valid emails that passed the cleaning process.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it Works`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Complete Email Cleaning`,children:_jsxs(_components.p,{children:[`First use the `,_jsx(_components.a,{href:`/api-reference/endpoint/clean_list`,children:`Clean Email List`}),`\nendpoint to process your file`]})}),_jsx(Step,{title:`Verify Cleaning Status`,children:_jsxs(_components.p,{children:[`Ensure the file status is “cleaned” using the `,_jsx(_components.a,{href:`/api-reference/endpoint/view_file`,children:`Get File\nDetails`}),` endpoint`]})}),_jsx(Step,{title:`Request Download URL`,children:_jsx(_components.p,{children:`Use this endpoint with the file_id to get a secure download URL`})}),_jsx(Step,{title:`Download the File`,children:_jsx(_components.p,{children:`Use the provided download_url to download your cleaned email list`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-this-endpoint`,children:`When to Use This Endpoint`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Export Clean Data`,icon:`download`,children:_jsx(_components.p,{children:`Download validated emails for use in marketing campaigns or CRM systems`})}),_jsx(Card,{title:`Backup Clean Lists`,icon:`shield-check`,children:_jsx(_components.p,{children:`Save cleaned email lists to your local storage or backup systems`})}),_jsx(Card,{title:`Integration with Tools`,icon:`arrows-rotate`,children:_jsx(_components.p,{children:`Import clean email lists into email marketing platforms or databases`})}),_jsx(Card,{title:`Share Clean Results`,icon:`share`,children:_jsx(_components.p,{children:`Provide cleaned email lists to team members or clients`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`example-usage`,children:`Example Usage`}),`\n`,_jsx(CodeBlock,{filename:``,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://base.sanitizeemail.com/v1/api/cleanedemail/download-cleaned-emails/?file_id={id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: YOUR_API_KEY\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`file_id`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`ID of the file with cleaned emails`})]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`File ID Required`}),`: The file_id must correspond to a file that has been\nsuccessfully cleaned and has a status of “cleaned”.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response-format`,children:`Response Format`}),`\n`,_jsx(Heading,{level:`3`,id:`successful-response`,children:`Successful Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,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:` \"download_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{YOUR_FILE_URL}\"`}),_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:` \"filename\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cleaned_emails_757_1752553258.csv\"`}),_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:` \"file_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"757\"`}),_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:` \"record_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`172`}),_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:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"csv\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`download_url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Secure pre-signed URL for downloading the cleaned email file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`filename`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Name of the generated clean email file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`file_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ID of the original file that was cleaned`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`record_count`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Number of clean emails in the downloadable file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`format`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`File format (always “csv” for clean email lists)`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`download-url-characteristics`,children:`Download URL Characteristics`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Secure Access`,icon:`lock`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Pre-signed URLs`}),`: Download URLs are secure and temporarily accessible\nwithout additional authentication`]})}),_jsx(Card,{title:`Time-Limited`,icon:`clock`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Expiration`}),`: URLs typically expire after a set period for security\npurposes`]})}),_jsx(Card,{title:`Direct Download`,icon:`download`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Ready to Use`}),`: URLs can be used directly in browsers or download tools`]})}),_jsx(Card,{title:`CSV Format`,icon:`file-csv`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Standard Format`}),`: Files are provided in CSV format for maximum\ncompatibility`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`understanding-the-downloaded-file`,children:`Understanding the Downloaded File`}),`\n`,_jsx(_components.p,{children:`The downloaded CSV file contains:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Clean Email Addresses`}),`: Only emails that passed all validation checks`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Standard CSV Format`}),`: Compatible with spreadsheet applications and databases`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No Headers`}),`: Simple list format with one email per line`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`UTF-8 Encoding`}),`: Supports international characters and domains`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`important-notes`,children:`Important Notes`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cleaning Required`}),`: This endpoint only works with files that have been\nprocessed through the cleaning workflow and have a status of “cleaned”.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Download Immediately`}),`: For best results, download the file as soon as you\nreceive the URL to avoid potential expiration.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`URL Security`}),`: Keep download URLs confidential as they provide temporary\naccess to your cleaned email data.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`common-scenarios`,children:`Common Scenarios`}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-1-file-not-cleaned`,children:`Scenario 1: File Not Cleaned`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// If file is still processing:`})}),`\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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"File is still being processed\"`}),_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:` \"file_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"processing\"`}),_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:` \"progress_percentage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`75`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-2-no-clean-emails`,children:`Scenario 2: No Clean Emails`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// If cleaning found no valid emails:`})}),`\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:` \"download_url\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"No clean emails found in this file\"`}),_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:` \"record_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-3-successful-download`,children:`Scenario 3: Successful Download`}),`\n`,_jsx(CodeBlock,{filename:``,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:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Use the download_url to get your file`})}),`\n`,_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:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"my_clean_emails.csv\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"{YOUR_FILE_URL}\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`error-responses`,children:`Error Responses`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status Code`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Invalid or missing file_id parameter`}),_jsx(_components.td,{children:`Verify the file_id value`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Unauthorized access`}),_jsx(_components.td,{children:`Check your API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`File not found or not accessible`}),_jsx(_components.td,{children:`Ensure file exists and belongs to you`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:`File not ready for download`}),_jsx(_components.td,{children:`Wait for cleaning to complete`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Required Steps`}),`: 1. Upload file using `,_jsx(_components.a,{href:`/api-reference/endpoint/file_upload`,children:`File\nUpload`}),` 2. Clean file using `,_jsx(_components.a,{href:`/api-reference/endpoint/clean_list`,children:`Clean Email\nList`}),` 3. Wait for cleaning to complete\n(status = “cleaned”) 4. Use this endpoint to get download URL`]})}),`\n`,_jsx(Heading,{level:`2`,id:`download-workflow-example`,children:`Download Workflow Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,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:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 1. Check file status first`})}),`\n`,_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://base.sanitizeemail.com/v1/api/filesupload/{id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: YOUR_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Response should show: \"status\": \"cleaned\"`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 2. Get download URL`})}),`\n`,_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://base.sanitizeemail.com/v1/api/cleanedemail/download-cleaned-emails/?file_id={id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: YOUR_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 3. Download the file`})}),`\n`,_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:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"clean_emails.csv\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"DOWNLOAD_URL_FROM_RESPONSE\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`integration-tips`,children:`Integration Tips`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Automated Downloads`,icon:`robot`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scripting`}),`: Integrate this endpoint into automated workflows for regular\nemail list cleaning`]})}),_jsx(Card,{title:`Webhook Integration`,icon:`webhook`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Event-Driven`}),`: Trigger downloads automatically when cleaning jobs\ncomplete`]})}),_jsx(Card,{title:`Batch Processing`,icon:`layer-group`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Multiple Files`}),`: Process multiple files and download all clean lists in\nsequence`]})}),_jsx(Card,{title:`Data Pipeline`,icon:`diagram-project`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`ETL Workflows`}),`: Incorporate into data processing pipelines for continuous\nemail hygiene`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`View Clean Results`,icon:`list`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/endpoint/clean_list_result`,children:`View Clean List Results`}),` to\npreview clean emails before downloading`]})}),_jsx(Card,{title:`Clean Email List`,icon:`broom`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/endpoint/clean_list`,children:`Clean Email List`}),` to initiate the\ncleaning process`]})})]})]})}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":"Download Clean List","openapi":"GET /v1/api/cleanedemail/download-cleaned-emails/","description":"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.","href":"/api-reference/endpoint/download_clean_list","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it Works","slug":"how-it-works","depth":2,"children":[]},{"title":"When to Use This Endpoint","slug":"when-to-use-this-endpoint","depth":2,"children":[]},{"title":"Example Usage","slug":"example-usage","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response Format","slug":"response-format","depth":2,"children":[{"title":"Successful Response","slug":"successful-response","depth":3,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":3,"children":[]}]},{"title":"Download URL Characteristics","slug":"download-url-characteristics","depth":2,"children":[]},{"title":"Understanding the Downloaded File","slug":"understanding-the-downloaded-file","depth":2,"children":[]},{"title":"Important Notes","slug":"important-notes","depth":2,"children":[]},{"title":"Common Scenarios","slug":"common-scenarios","depth":2,"children":[{"title":"Scenario 1: File Not Cleaned","slug":"scenario-1-file-not-cleaned","depth":3,"children":[]},{"title":"Scenario 2: No Clean Emails","slug":"scenario-2-no-clean-emails","depth":3,"children":[]},{"title":"Scenario 3: Successful Download","slug":"scenario-3-successful-download","depth":3,"children":[]}]},{"title":"Error Responses","slug":"error-responses","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Download Workflow Example","slug":"download-workflow-example","depth":2,"children":[]},{"title":"Integration Tips","slug":"integration-tips","depth":2,"children":[]},{"title":"Related Endpoints","slug":"related-endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Download Clean Email List","description":"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.","tags":["Email Cleaning"],"parameters":["2b5d9005-c633-4ecd-9394-264c87e66789"],"responses":{"200":"a0287527-ce0b-49a2-b5c6-8653883541d9","400":"6ca9ee86-0400-41b5-a0ba-714787ba561c","401":"0cd37805-f8a3-472f-8e24-109bd1d4a37e","404":"48d35456-dfc0-4b00-bc92-d2d9afc34990","409":"f4ff270d-e8df-4640-9f60-3886f6cddf3d"},"method":"get","type":"path","servers":["ca31efd6-2adb-4d0e-9d40-4acd0d3193b1"],"security":["6b03ea10-a856-4a37-a66c-71bc344a78c8"],"path":"/v1/api/cleanedemail/download-cleaned-emails/","baseUrlOptions":["https://base.sanitizeemail.com"],"title":"Download Clean Email List","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2b5d9005-c633-4ecd-9394-264c87e66789":{"name":"file_id","in":"query","required":true,"schema":{"type":"integer","isRequired":true,"description":"The ID of the file for which to generate a download URL.","uniqueKey":"","typeLabel":"integer"},"description":"The ID of the file for which to generate a download URL.","example":757}},"responses":{"a0287527-ce0b-49a2-b5c6-8653883541d9":{"description":"Download URL generated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"download_url":{"type":"string","format":"uri","description":"Secure pre-signed URL for downloading the cleaned email file","isRequired":true,"uniqueKey":"download_url","typeLabel":"string\u003curi>"},"filename":{"type":"string","description":"Name of the generated clean email file","isRequired":true,"uniqueKey":"filename","typeLabel":"string"},"file_id":{"type":"string","description":"ID of the original file that was cleaned","isRequired":true,"uniqueKey":"file_id","typeLabel":"string"},"record_count":{"type":"integer","description":"Number of clean emails in the downloadable file","isRequired":true,"uniqueKey":"record_count","typeLabel":"integer"},"format":{"type":"string","enum":["csv"],"description":"File format of the downloadable file","isRequired":true,"uniqueKey":"format","typeLabel":"enum\u003cstring>"}},"required":["download_url","filename","file_id","record_count","format"],"example":{"download_url":"{YOUR_DOWNLOAD_URL}","filename":"your_cleaned_emails.csv","file_id":"{id}","record_count":172,"format":"csv"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"download_url":"{YOUR_DOWNLOAD_URL}","filename":"your_cleaned_emails.csv","file_id":"{id}","record_count":172,"format":"csv"}}},"exampleType":"generated"}},"exampleType":"generated"},"6ca9ee86-0400-41b5-a0ba-714787ba561c":{"description":"Bad Request - Invalid or missing file_id parameter","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"0cd37805-f8a3-472f-8e24-109bd1d4a37e":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"48d35456-dfc0-4b00-bc92-d2d9afc34990":{"description":"File not found","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f4ff270d-e8df-4640-9f60-3886f6cddf3d":{"description":"Conflict - File not ready for download","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"File is still being processed","file_status":"processing","progress_percentage":75},"examples":{"Example":{"title":"Example","value":{"error":"File is still being processed","file_status":"processing","progress_percentage":75}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6b03ea10-a856-4a37-a66c-71bc344a78c8":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication","scopes":[]}}},"servers":{"ca31efd6-2adb-4d0e-9d40-4acd0d3193b1":{"url":"https://base.sanitizeemail.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication","scopes":[]},"schema":{"title":"X-API-KEY","type":"string","description":"API key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"X-API-KEY"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"sanitizeemail","siteName":"Sanitize Email API Docs","title":"Download Clean List - Sanitize Email API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T09:46:39.515Z","originalFileLocation":"api-reference/endpoint/download_clean_list.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=\"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sanitize Email API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_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/sanitizeemail/_GQ_575T0N5dLEtb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Download Clean List - Sanitize Email API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sanitize Email API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sanitizeemail.mintlify.site/_mintlify/api/og/v2?division=Download+Results\u0026amp;title=Download+Clean+List\u0026amp;description=Generates+and+provides+a+download+URL+for+the+cleaned+email+list+from+a+processed+file.+Returns+a+secure%2C+time-limited+URL+to+download+a+CSV+file+containing+onl\u0026amp;theme=9d04777a0ebfbd0878ebcbed\u0026amp;signature=d1aba71fab5a56a63489a18922721beeb0d00306ad6b282a663b8c1db363bba8\">\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=\"Download Clean List - Sanitize Email API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sanitizeemail.mintlify.site/_mintlify/api/og/v2?division=Download+Results\u0026amp;title=Download+Clean+List\u0026amp;description=Generates+and+provides+a+download+URL+for+the+cleaned+email+list+from+a+processed+file.+Returns+a+secure%2C+time-limited+URL+to+download+a+CSV+file+containing+onl\u0026amp;theme=9d04777a0ebfbd0878ebcbed\u0026amp;signature=d1aba71fab5a56a63489a18922721beeb0d00306ad6b282a663b8c1db363bba8\">\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/sanitizeemail/_GQ_575T0N5dLEtb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sanitize Email API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7f56d9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/download_clean_list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sanitizeemail.com/#organization\",\"name\":\"Sanitize Email API Docs\",\"url\":\"https://docs.sanitizeemail.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sanitizeemail/FMqKL5b2i6-mwdGF/logo/light.svg?fit=max\u0026auto=format\u0026n=FMqKL5b2i6-mwdGF\u0026q=85\u0026s=46346baef74643b10ebb614be40687b2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sanitizeemail.com#website\",\"name\":\"Sanitize Email API Docs\",\"url\":\"https://docs.sanitizeemail.com\",\"publisher\":{\"@id\":\"https://docs.sanitizeemail.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list#webpage\",\"url\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list\",\"name\":\"Download Clean List\",\"description\":\"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.\",\"dateModified\":\"2026-01-07T09:46:39.515Z\",\"isPartOf\":{\"@id\":\"https://docs.sanitizeemail.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sanitize Email API Docs\",\"item\":\"https://docs.sanitizeemail.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Download Clean List\",\"item\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list#apireference\",\"headline\":\"Download Clean List\",\"name\":\"Download Clean List\",\"description\":\"Generates and provides a download URL for the cleaned email list from a processed file. Returns a secure, time-limited URL to download a CSV file containing only valid emails.\",\"url\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list#webpage\"},\"dateModified\":\"2026-01-07T09:46:39.515Z\",\"publisher\":{\"@id\":\"https://docs.sanitizeemail.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sanitizeemail.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sanitize Email API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sanitize Email API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/download_clean_list.md","siteName":"Sanitize Email API Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"File endpoints","pages":[{"title":"Upload CSV or XLSX","openapi":"POST /v1/api/filesupload/","href":"/api-reference/endpoint/file_upload"},{"title":"List Uploaded Files","openapi":"GET /v1/api/filesupload/","href":"/api-reference/endpoint/view_all_files"},{"title":"View File Details","openapi":"GET /v1/api/filesupload/{file_id}","href":"/api-reference/endpoint/view_file"}]},{"group":"Validation endpoints","pages":[{"title":"Analyze Email List","openapi":"POST /v1/api/filesupload/analyze-list/","href":"/api-reference/endpoint/analyze_list"},{"title":"Validate Emails","openapi":"POST /v1/api/email-validation/","href":"/api-reference/endpoint/validate_emails"},{"title":"Clean Email List","openapi":"POST /v1/api/cleanemail/","href":"/api-reference/endpoint/clean_list"}]},{"group":"Get Results","pages":[{"title":"View Clean List Results","openapi":"GET /v1/api/cleanedemail/","href":"/api-reference/endpoint/clean_list_result"},{"title":"View Validation Results","openapi":"GET /v1/api/email-validation/","description":"Retrieves a paginated list of detailed validation results for a file that has been processed. This endpoint should be used after a file's status is 'validated'.","href":"/api-reference/endpoint/validation_result"}]},{"group":"Download Results","pages":[{"title":"Download Clean List","openapi":"GET /v1/api/cleanedemail/download-cleaned-emails/","href":"/api-reference/endpoint/download_clean_list"},{"title":"Download Validation Results","openapi":"GET /v1/api/email-validation/download-validation-results/","description":"Generates and provides a download URL for the validation results from a processed file. Returns a secure, time-limited URL to download a CSV file containing detailed validation results for all processed emails.","href":"/api-reference/endpoint/download_validated_list"}]}]}]},"basePath":"","title":"Download Clean List - Sanitize Email API Docs","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}