{
"error": "File is still being processed",
"file_status": "processing",
"progress_percentage": 65
}
Download Results
Download Validation Results
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.
GET
/
v1
/
api
/
email-validation
/
download-validation-results
/
Download Validation Results
curl --request GET \
--url https://base.sanitizeemail.com/v1/api/email-validation/download-validation-results/ \
--header 'X-API-KEY: <api-key>'
{
"error": "File is still being processed",
"file_status": "processing",
"progress_percentage": 65
}
This endpoint generates and provides a download URL for the validation results from a processed file. Use this to download a CSV file containing detailed validation results for all emails that were processed.
Secure pre-signed URL for downloading the validation results file
filename
string
Name of the generated validation results file
file_id
string
ID of the original file that was validated
record_count
integer
Number of validation records in the downloadable file
format
string
File format (always “csv” for validation results)
Download URL Characteristics
Secure Access
Pre-signed URLs: Download URLs are secure and temporarily accessible
without additional authentication
Time-Limited
Expiration: URLs typically expire after a set period for security
purposes
Direct Download
Ready to Use: URLs can be used directly in browsers or download tools
CSV Format
Standard Format: Files are provided in CSV format for maximum
compatibility
Understanding the Downloaded File
The downloaded CSV file contains comprehensive validation data:
Email Address: Original email addresses that were validated
Validation Status: Valid, invalid, or unknown status for each email
Detailed Reasons: Specific reasons for validation results (syntax, DNS, MX, SMTP, DMARC)
Email Classification: Type (business/personal), disposable status, role account detection
Technical Details: MX records, validation timing, DMARC policy information
Standard CSV Format: Compatible with spreadsheet applications and databases
UTF-8 Encoding: Supports international characters and domains
CSV File Structure
The validation results CSV typically includes these columns:
Column
Description
email
Original email address
status
Overall validation result (valid/invalid/unknown)
normalized_email
Cleaned/normalized version of the email
is_disposable
Whether email is from disposable service
is_role_account
Whether email is a role-based account
type
Email type classification
mx_records
MX records for the domain
validation_reasons
Detailed breakdown of validation checks
dmarc_policy
DMARC policy information
created_date
When the validation was performed
Important Notes
Validation Required: This endpoint only works with files that have been
processed through the validation workflow and have a status of “validated”.
Download Immediately: For best results, download the file as soon as you
receive the URL to avoid potential expiration.
URL Security: Keep download URLs confidential as they provide temporary
access to your validation data.
Common Scenarios
Scenario 1: File Not Validated
// If file is still processing:{ "error": "File is still being processed", "file_status": "processing", "progress_percentage": 65}
Scenario 2: No Validation Results
// If validation found no processable emails:{ "download_url": null, "message": "No validation results found for this file", "record_count": 0}
Scenario 3: Successful Download
# Use the download_url to get your filecurl -o "validation_results.csv" "{YOUR_FILE_URL}"
Error Responses
Status Code
Description
Action
400
Invalid or missing file_id parameter
Verify the file_id value
401
Unauthorized access
Check your API key
404
File not found or not accessible
Ensure file exists and belongs to you
409
File not ready for download
Wait for validation to complete
Prerequisites
Required Steps: 1. Upload file using File
Upload 2. Validate file using Validate
Email Addresses 3. Wait for
validation to complete (status = “validated”) 4. Use this endpoint to get
download URL
Download Workflow Example
# 1. Check file status firstcurl -X GET "https://base.sanitizeemail.com/v1/api/filesupload/740" \ -H "X-API-KEY: YOUR_API_KEY"# Response should show: "status": "validated"# 2. Get download URLcurl -X GET "https://base.sanitizeemail.com/v1/api/email-validation/download-validation-results/?file_id=740" \ -H "X-API-KEY: YOUR_API_KEY"# 3. Download the filecurl -o "validation_results.csv" "DOWNLOAD_URL_FROM_RESPONSE"
Differences from Clean List Download
Clean List Download
Content: Only valid emails that passed all checks Use Case: Email
marketing campaigns, direct outreach File Size: Smaller (filtered data)
Validation Results Download
Content: All emails with detailed validation analysis Use Case: Data
analysis, reporting, compliance File Size: Larger (comprehensive data)
Integration Tips
Data Analysis
Business Intelligence: Import into BI tools for email quality insights
and trends
Compliance Reporting
Audit Trail: Maintain detailed records of email validation for
compliance purposes
Quality Monitoring
Performance Tracking: Monitor email list quality over time with detailed
metrics
Integration Workflows
Data Pipelines: Feed validation results into CRM systems or marketing
automation platforms
The ID of the file for which to generate a download URL.
Response
Download URL generated successfully
download_url
string<uri>
required
Secure pre-signed URL for downloading the validation results file
filename
string
required
Name of the generated validation results file
file_id
string
required
ID of the original file that was validated
record_count
integer
required
Number of validation records in the downloadable file
format
enum<string>
required
File format of the downloadable file
Available options:
csv
{"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.4143","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":[{"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"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_validated_list","slug":"/api-reference/endpoint/download_validated_list","pageMetadata":{"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","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 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.\"\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 validation results from a processed file. Use this to download a CSV file containing detailed validation results for all emails that were processed.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it Works`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Complete Email Validation`,children:_jsxs(_components.p,{children:[`First use the `,_jsx(_components.a,{href:`/api-reference/endpoint/validate_emails`,children:`Validate Email\nAddresses`}),` endpoint to process your\nfile`]})}),_jsx(Step,{title:`Verify Validation Status`,children:_jsxs(_components.p,{children:[`Ensure the file status is “validated” 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 validation results`})})]}),`\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 Validation Data`,icon:`download`,children:_jsx(_components.p,{children:`Download detailed validation results for analysis, reporting, or integration`})}),_jsx(Card,{title:`Backup Validation Results`,icon:`shield-check`,children:_jsx(_components.p,{children:`Save validation results to your local storage or backup systems`})}),_jsx(Card,{title:`Integration with Analytics`,icon:`chart-line`,children:_jsx(_components.p,{children:`Import validation data into analytics platforms or business intelligence\ntools`})}),_jsx(Card,{title:`Share Detailed Reports`,icon:`share`,children:_jsx(_components.p,{children:`Provide comprehensive validation reports 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/email-validation/download-validation-results/?file_id=740\"`}),_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 validation results`})]})})]}),`\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 validated and has a status of “validated”.`]})}),`\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:`\"validation_results_740_1752553784.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:`\"740\"`}),_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:`4`}),_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 validation results 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 validation results 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 validated`})]}),_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 validation records 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 validation results)`})]})]})]}),`\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 comprehensive validation data:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Email Address`}),`: Original email addresses that were validated`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Validation Status`}),`: Valid, invalid, or unknown status for each email`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Detailed Reasons`}),`: Specific reasons for validation results (syntax, DNS, MX, SMTP, DMARC)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Email Classification`}),`: Type (business/personal), disposable status, role account detection`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Technical Details`}),`: MX records, validation timing, DMARC policy information`]}),`\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:`UTF-8 Encoding`}),`: Supports international characters and domains`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`csv-file-structure`,children:`CSV File Structure`}),`\n`,_jsx(_components.p,{children:`The validation results CSV typically includes these columns:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Column`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`email`})}),_jsx(_components.td,{children:`Original email address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`Overall validation result (valid/invalid/unknown)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`normalized_email`})}),_jsx(_components.td,{children:`Cleaned/normalized version of the email`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_disposable`})}),_jsx(_components.td,{children:`Whether email is from disposable service`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_role_account`})}),_jsx(_components.td,{children:`Whether email is a role-based account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`Email type classification`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mx_records`})}),_jsx(_components.td,{children:`MX records for the domain`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`validation_reasons`})}),_jsx(_components.td,{children:`Detailed breakdown of validation checks`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`dmarc_policy`})}),_jsx(_components.td,{children:`DMARC policy information`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_date`})}),_jsx(_components.td,{children:`When the validation was performed`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`important-notes`,children:`Important Notes`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Validation Required`}),`: This endpoint only works with files that have been\nprocessed through the validation workflow and have a status of “validated”.`]})}),`\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 validation data.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`common-scenarios`,children:`Common Scenarios`}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-1-file-not-validated`,children:`Scenario 1: File Not Validated`}),`\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:`65`})]}),`\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-validation-results`,children:`Scenario 2: No Validation Results`}),`\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 validation found no processable 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 validation results found for 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:` \"validation_results.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 validation 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. Validate file using `,_jsx(_components.a,{href:`/api-reference/endpoint/validate_emails`,children:`Validate\nEmail Addresses`}),` 3. Wait for\nvalidation to complete (status = “validated”) 4. Use this endpoint to get\ndownload 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/740\"`}),_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\": \"validated\"`})}),`\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/email-validation/download-validation-results/?file_id=740\"`}),_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:` \"validation_results.csv\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"DOWNLOAD_URL_FROM_RESPONSE\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`differences-from-clean-list-download`,children:`Differences from Clean List Download`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Clean List Download`,icon:`broom`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Content`}),`: Only valid emails that passed all checks `,_jsx(_components.strong,{children:`Use Case`}),`: Email\nmarketing campaigns, direct outreach `,_jsx(_components.strong,{children:`File Size`}),`: Smaller (filtered data)`]})}),_jsx(Card,{title:`Validation Results Download`,icon:`chart-bar`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Content`}),`: All emails with detailed validation analysis `,_jsx(_components.strong,{children:`Use Case`}),`: Data\nanalysis, reporting, compliance `,_jsx(_components.strong,{children:`File Size`}),`: Larger (comprehensive data)`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`integration-tips`,children:`Integration Tips`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Data Analysis`,icon:`magnifying-glass-chart`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Business Intelligence`}),`: Import into BI tools for email quality insights\nand trends`]})}),_jsx(Card,{title:`Compliance Reporting`,icon:`file-contract`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Audit Trail`}),`: Maintain detailed records of email validation for\ncompliance purposes`]})}),_jsx(Card,{title:`Quality Monitoring`,icon:`gauge-high`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Performance Tracking`}),`: Monitor email list quality over time with detailed\nmetrics`]})}),_jsx(Card,{title:`Integration Workflows`,icon:`arrows-rotate`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Data Pipelines`}),`: Feed validation results into CRM systems or marketing\nautomation platforms`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`View Validation Results`,icon:`list`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/endpoint/validation_result`,children:`View Validation Results`}),` to\npreview validation data before downloading`]})}),_jsx(Card,{title:`Validate Email Addresses`,icon:`envelope-circle-check`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/endpoint/validate_emails`,children:`Validate Email Addresses`}),` to\ninitiate the validation 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 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","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":"CSV File Structure","slug":"csv-file-structure","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 Validated","slug":"scenario-1-file-not-validated","depth":3,"children":[]},{"title":"Scenario 2: No Validation Results","slug":"scenario-2-no-validation-results","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":"Differences from Clean List Download","slug":"differences-from-clean-list-download","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 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.","tags":["Email Validation"],"parameters":["64f1bd34-7c09-4dae-b401-ac1de00630dc"],"responses":{"200":"4ca1a0ce-3f34-4436-8655-caa0d4ced4af","400":"46fa95e5-7885-4d21-b842-8ff6c43dcbf2","401":"0ade7ec4-8e1a-4333-8b63-8818bc92608b","404":"0bf7a3cc-bcbe-4cdc-a118-4dba4c0ae64f","409":"ba8afbd8-53d4-4eff-8bb1-364e926d907e"},"method":"get","type":"path","servers":["ca31efd6-2adb-4d0e-9d40-4acd0d3193b1"],"security":["6b03ea10-a856-4a37-a66c-71bc344a78c8"],"path":"/v1/api/email-validation/download-validation-results/","baseUrlOptions":["https://base.sanitizeemail.com"],"title":"Download Validation Results","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"64f1bd34-7c09-4dae-b401-ac1de00630dc":{"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":{"4ca1a0ce-3f34-4436-8655-caa0d4ced4af":{"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 validation results file","isRequired":true,"uniqueKey":"download_url","typeLabel":"string\u003curi>"},"filename":{"type":"string","description":"Name of the generated validation results file","isRequired":true,"uniqueKey":"filename","typeLabel":"string"},"file_id":{"type":"string","description":"ID of the original file that was validated","isRequired":true,"uniqueKey":"file_id","typeLabel":"string"},"record_count":{"type":"integer","description":"Number of validation records 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":"validation_results_740_1752553784.csv","file_id":"740","record_count":4,"format":"csv"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"download_url":"{YOUR_DOWNLOAD_URL}","filename":"validation_results_740_1752553784.csv","file_id":"740","record_count":4,"format":"csv"}}},"exampleType":"generated"}},"exampleType":"generated"},"46fa95e5-7885-4d21-b842-8ff6c43dcbf2":{"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"},"0ade7ec4-8e1a-4333-8b63-8818bc92608b":{"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"},"0bf7a3cc-bcbe-4cdc-a118-4dba4c0ae64f":{"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"},"ba8afbd8-53d4-4eff-8bb1-364e926d907e":{"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":65},"examples":{"Example":{"title":"Example","value":{"error":"File is still being processed","file_status":"processing","progress_percentage":65}}},"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 Validation Results - Sanitize Email API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-01T10:43:18.931Z","originalFileLocation":"api-reference/endpoint/download_validated_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 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.\">\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 Validation Results - Sanitize Email API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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_validated_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+Validation+Results\u0026amp;description=Generates+and+provides+a+download+URL+for+the+validation+results+from+a+processed+file.+Returns+a+secure%2C+time-limited+URL+to+download+a+CSV+file+containing+det\u0026amp;theme=9d04777a0ebfbd0878ebcbed\u0026amp;signature=8caca2c02ada99ca4938e12c09a54bbdf3d29b2433237b0e07af9939d12e3e14\">\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 Validation Results - Sanitize Email API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sanitizeemail.mintlify.site/_mintlify/api/og/v2?division=Download+Results\u0026amp;title=Download+Validation+Results\u0026amp;description=Generates+and+provides+a+download+URL+for+the+validation+results+from+a+processed+file.+Returns+a+secure%2C+time-limited+URL+to+download+a+CSV+file+containing+det\u0026amp;theme=9d04777a0ebfbd0878ebcbed\u0026amp;signature=8caca2c02ada99ca4938e12c09a54bbdf3d29b2433237b0e07af9939d12e3e14\">\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_validated_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_validated_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_validated_list#webpage\",\"url\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list\",\"name\":\"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.\",\"dateModified\":\"2026-02-01T10:43:18.931Z\",\"isPartOf\":{\"@id\":\"https://docs.sanitizeemail.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Download Results\",\"item\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_clean_list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Download Validation Results\",\"item\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list#apireference\",\"headline\":\"Download Validation Results\",\"name\":\"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.\",\"url\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/download_validated_list#webpage\"},\"dateModified\":\"2026-02-01T10:43:18.931Z\",\"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_validated_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/","href":"/api-reference/endpoint/validation_result"}]},{"group":"Download Results","pages":[{"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"},{"title":"Download Validation Results","openapi":"GET /v1/api/email-validation/download-validation-results/","href":"/api-reference/endpoint/download_validated_list"}]}]}]},"basePath":"","title":"Download Validation Results - Sanitize Email API Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}