This endpoint allows users to upload CSV or XLSX files for bulk email validation. It supports both organized files (with headers) and unorganized files, with intelligent email column detection.
How it Works
1
Upload File
Submit your CSV or XLSX file with the required parameters
2
Column Detection
If is_file_organised is true, the API automatically detects email columns
3
Column Selection (if needed)
If no email column is found, you’ll receive suggestions to choose the
correct column
4
Processing
Resubmit with the chosen email_column to start validation
Important Notes
Column Selection: You can always provide an email_column parameter, even
on the first upload. It’s particularly useful when you know the exact column
name containing email addresses.
File Resubmission: If you receive a 200 response with available_columns,
resubmit the same file with the chosen email_column to proceed with
processing.
File Organization: Set is_file_organised=false for files without headers
or with inconsistent structure. The API will attempt to detect emails from the
raw data.
Authorizations
X-API-KEY
string
header
required
API key for authentication
Body
multipart/form-data
File upload with form data
file
file
required
The CSV or XLSX file to upload for email validation
name
string
required
Display name for the uploaded file
Example:
"Customer List"
is_file_organised
boolean
required
Whether the file has a structured format with column headers. Set to true for files with headers, false for unorganized data.
Example:
true
file_tag
enum<string>
required
Tag to categorize the file processing type. 'clean' removes invalid emails, 'validate' checks email validity, 'analyze' provides detailed email insights.
Available options:
clean,
validate,
analyze
Example:
"clean"
email_column
string
Name of the column containing email addresses. Optional on first upload, but required if the API returns column suggestions.
Example:
"email_address"
Response
File uploaded but requires email column selection
error
string
Error message indicating no email columns found
is_first_time
boolean
Whether this is the first upload attempt
available_columns
string[]
List of available column names in the file
sample_first_3_rows
object[]
Sample of first 3 rows to help identify the correct email column
{"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/file_upload","slug":"/api-reference/endpoint/file_upload","pageMetadata":{"title":"Upload CSV or XLSX","openapi":"POST /v1/api/filesupload/","description":"Upload CSV or XLSX files for bulk email validation with automatic email column detection","href":"/api-reference/endpoint/file_upload","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: \"Upload CSV or XLSX files for bulk email validation with automatic email column detection\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Note,Step,Steps,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This endpoint allows users to upload CSV or XLSX files for bulk email validation. It supports both organized files (with headers) and unorganized files, with intelligent email column detection.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it Works`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Upload File`,children:_jsx(_components.p,{children:`Submit your CSV or XLSX file with the required parameters`})}),_jsx(Step,{title:`Column Detection`,children:_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`is_file_organised`}),` is true, the API automatically detects email columns`]})}),_jsx(Step,{title:`Column Selection (if needed)`,children:_jsx(_components.p,{children:`If no email column is found, you’ll receive suggestions to choose the\ncorrect column`})}),_jsx(Step,{title:`Processing`,children:_jsxs(_components.p,{children:[`Resubmit with the chosen `,_jsx(_components.code,{children:`email_column`}),` to start validation`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`important-notes`,children:`Important Notes`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Column Selection`}),`: You can always provide an `,_jsx(_components.code,{children:`email_column`}),` parameter, even\non the first upload. It’s particularly useful when you know the exact column\nname containing email addresses.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`File Resubmission`}),`: If you receive a 200 response with `,_jsx(_components.code,{children:`available_columns`}),`,\nresubmit the same file with the chosen `,_jsx(_components.code,{children:`email_column`}),` to proceed with\nprocessing.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`File Organization`}),`: Set `,_jsx(_components.code,{children:`is_file_organised=false`}),` for files without headers\nor with inconsistent structure. The API will attempt to detect emails from the\nraw data.`]})})]})}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":"Upload CSV or XLSX","openapi":"POST /v1/api/filesupload/","description":"Upload CSV or XLSX files for bulk email validation with automatic email column detection","href":"/api-reference/endpoint/file_upload","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it Works","slug":"how-it-works","depth":2,"children":[]},{"title":"Important Notes","slug":"important-notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Upload CSV or XLSX File","description":"Upload CSV or XLSX files for bulk email validation with automatic email column detection","tags":["File Upload"],"requestBody":"eb980657-fc28-4de6-9dfb-eb55f877e0cd","responses":{"200":"fe41c9d3-a1c7-4626-bf2a-099d6b17456c","201":"7cfb9399-b117-4911-bb2a-46b1cc46a68a","400":"7154b84f-5d93-4859-95cf-740c757c1821","401":"ccc6717f-694d-4b2e-930e-156ee04793ef","413":"c777ad5c-3ed6-4257-b247-85d391eca7fc","429":"1795e69a-80e0-41e4-ae39-d91c7a9409f6"},"method":"post","type":"path","servers":["ca31efd6-2adb-4d0e-9d40-4acd0d3193b1"],"security":["6b03ea10-a856-4a37-a66c-71bc344a78c8"],"path":"/v1/api/filesupload/","baseUrlOptions":["https://base.sanitizeemail.com"],"title":"Upload CSV or XLSX File","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"File upload with form data","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file","name","is_file_organised","file_tag"],"properties":{"file":{"type":"string","format":"binary","description":"The CSV or XLSX file to upload for email validation","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"name":{"type":"string","description":"Display name for the uploaded file","example":"Customer List","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"is_file_organised":{"type":"boolean","description":"Whether the file has a structured format with column headers. Set to true for files with headers, false for unorganized data.","example":true,"isRequired":true,"uniqueKey":"is_file_organised","typeLabel":"boolean"},"file_tag":{"type":"string","enum":["clean","validate","analyze"],"description":"Tag to categorize the file processing type. 'clean' removes invalid emails, 'validate' checks email validity, 'analyze' provides detailed email insights.","example":"clean","isRequired":true,"uniqueKey":"file_tag","typeLabel":"enum\u003cstring>"},"email_column":{"type":"string","description":"Name of the column containing email addresses. Optional on first upload, but required if the API returns column suggestions.","example":"email_address","uniqueKey":"email_column","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","name":"Customer List","is_file_organised":true,"file_tag":"clean","email_column":"email_address"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"fe41c9d3-a1c7-4626-bf2a-099d6b17456c":{"description":"File uploaded but requires email column selection","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message indicating no email columns found","uniqueKey":"error","typeLabel":"string"},"is_first_time":{"type":"boolean","description":"Whether this is the first upload attempt","uniqueKey":"is_first_time","typeLabel":"boolean"},"available_columns":{"type":"array","items":{"type":"string","uniqueKey":"available_columns.items.[INDEX]","typeLabel":"string"},"description":"List of available column names in the file","uniqueKey":"available_columns","typeLabel":"string[]"},"sample_first_3_rows":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"sample_first_3_rows.items.[INDEX]","typeLabel":"object"},"description":"Sample of first 3 rows to help identify the correct email column","uniqueKey":"sample_first_3_rows","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","is_first_time":true,"available_columns":["\u003cstring>"],"sample_first_3_rows":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7cfb9399-b117-4911-bb2a-46b1cc46a68a":{"description":"File successfully uploaded and queued for processing","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier for the uploaded file","uniqueKey":"id","typeLabel":"integer"},"name":{"type":"string","description":"Display name of the file","uniqueKey":"name","typeLabel":"string"},"file":{"type":"string","format":"uri","description":"URL to the uploaded file","uniqueKey":"file","typeLabel":"string\u003curi>"},"status":{"type":"string","enum":["pending","processing","completed","failed"],"description":"Current processing status of the file","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"file_tag":{"type":"string","enum":["clean","validate","analyze"],"description":"Tag associated with the file processing type","uniqueKey":"file_tag","typeLabel":"enum\u003cstring>"},"file_name":{"type":"string","description":"Original filename","uniqueKey":"file_name","typeLabel":"string"},"file_size":{"type":"string","description":"File size in bytes","uniqueKey":"file_size","typeLabel":"string"},"stats":{"type":"object","properties":{"total_processed":{"type":"integer","description":"Total number of rows processed","uniqueKey":"stats.total_processed","typeLabel":"integer"},"total_emails":{"type":"integer","description":"Total number of email addresses found","uniqueKey":"stats.total_emails","typeLabel":"integer"},"unique_emails":{"type":"integer","description":"Number of unique email addresses","uniqueKey":"stats.unique_emails","typeLabel":"integer"},"duplicate_emails":{"type":"integer","description":"Number of duplicate email addresses","uniqueKey":"stats.duplicate_emails","typeLabel":"integer"},"dropped_emails":{"type":"integer","description":"Number of emails that were dropped due to invalid format","uniqueKey":"stats.dropped_emails","typeLabel":"integer"},"email_columns_used":{"type":"array","items":{"type":"string","uniqueKey":"stats.email_columns_used.items.[INDEX]","typeLabel":"string"},"description":"Names of columns used for email extraction","uniqueKey":"stats.email_columns_used","typeLabel":"string[]"},"email_domains":{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"stats.email_domains.additionalProperties","typeLabel":"integer"},"description":"Count of emails per domain","uniqueKey":"stats.email_domains","typeLabel":"object"}},"uniqueKey":"stats","typeLabel":"object"},"clean_emails_available":{"type":"boolean","description":"Whether clean emails are available for download","uniqueKey":"clean_emails_available","typeLabel":"boolean"},"workspace":{"type":"string","description":"Workspace name where the file was uploaded","uniqueKey":"workspace","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"name":"\u003cstring>","file":"\u003cstring>","status":"pending","file_tag":"clean","file_name":"\u003cstring>","file_size":"\u003cstring>","stats":{"total_processed":123,"total_emails":123,"unique_emails":123,"duplicate_emails":123,"dropped_emails":123,"email_columns_used":["\u003cstring>"],"email_domains":{}},"clean_emails_available":true,"workspace":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7154b84f-5d93-4859-95cf-740c757c1821":{"description":"Bad request - Invalid file format or missing required parameters","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"},"ccc6717f-694d-4b2e-930e-156ee04793ef":{"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"},"c777ad5c-3ed6-4257-b247-85d391eca7fc":{"description":"File too large","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"},"1795e69a-80e0-41e4-ae39-d91c7a9409f6":{"description":"Rate limit exceeded","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"}},"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":"Upload CSV or XLSX - Sanitize Email API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T09:46:39.519Z","originalFileLocation":"api-reference/endpoint/file_upload.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=\"Upload CSV or XLSX files for bulk email validation with automatic email column detection\">\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=\"Upload CSV or XLSX - Sanitize Email API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload CSV or XLSX files for bulk email validation with automatic email column detection\">\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/file_upload\">\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=File+endpoints\u0026amp;title=Upload+CSV+or+XLSX\u0026amp;description=Upload+CSV+or+XLSX+files+for+bulk+email+validation+with+automatic+email+column+detection\u0026amp;theme=9d04777a0ebfbd0878ebcbed\u0026amp;signature=b7577773d206b297a122191e9f79ea5cfb72ee541a2aa56edb571396264aa024\">\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=\"Upload CSV or XLSX - Sanitize Email API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload CSV or XLSX files for bulk email validation with automatic email column detection\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sanitizeemail.mintlify.site/_mintlify/api/og/v2?division=File+endpoints\u0026amp;title=Upload+CSV+or+XLSX\u0026amp;description=Upload+CSV+or+XLSX+files+for+bulk+email+validation+with+automatic+email+column+detection\u0026amp;theme=9d04777a0ebfbd0878ebcbed\u0026amp;signature=b7577773d206b297a122191e9f79ea5cfb72ee541a2aa56edb571396264aa024\">\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/file_upload\">\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/file_upload.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/file_upload#webpage\",\"url\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload\",\"name\":\"Upload CSV or XLSX\",\"description\":\"Upload CSV or XLSX files for bulk email validation with automatic email column detection\",\"dateModified\":\"2026-01-07T09:46:39.519Z\",\"isPartOf\":{\"@id\":\"https://docs.sanitizeemail.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sanitize Email API Docs\",\"item\":\"https://docs.sanitizeemail.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload CSV or XLSX\",\"item\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload#apireference\",\"headline\":\"Upload CSV or XLSX\",\"name\":\"Upload CSV or XLSX\",\"description\":\"Upload CSV or XLSX files for bulk email validation with automatic email column detection\",\"url\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sanitizeemail.com/api-reference/endpoint/file_upload#webpage\"},\"dateModified\":\"2026-01-07T09:46:39.519Z\",\"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/file_upload.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","description":"Sanitize-Email API Documentation - Powerful email validation and management tool","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/","description":"Retrieve a paginated list of uploaded files with optional filtering by file tag","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/","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":"Upload CSV or XLSX - 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"]}