Skip to main content
POST
/
v1
/
api
/
filesupload
/
analyze-list
Analyze Email List
curl --request POST \
  --url https://base.sanitizeemail.com/v1/api/filesupload/analyze-list/ \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-KEY: <api-key>' \
  --form file_id=751 \
  --form 'name=Customer List Analysis'
{
  "file_id": 123,
  "bounce_rate": 123,
  "status": "analyzed"
}
This endpoint provides a quick analysis of an uploaded email list to estimate bounce rates and validation statistics without consuming credits. It performs intelligent sampling to deliver fast, approximate results that are close to actual values.

​
How it Works

1

Upload File First

Use the File Upload endpoint to upload your CSV or XLSX file and obtain the file_id
2

Submit Analysis Request

Send the analysis request with the file ID and list name
3

Get Instant Results

Receive bounce rate estimates and status immediately

​
Key Features

No Credits Required

Analyze your email lists without consuming any validation credits

Fast Results

Get bounce rate estimates in seconds, not minutes

Smart Sampling

Uses intelligent analysis to provide close approximations of actual rates

Pre-Validation Insights

Make informed decisions before running full validation

​
Use Cases

  • Quick Quality Assessment: Get a rapid overview of your email list quality
  • Budget Planning: Estimate validation costs before processing
  • List Comparison: Compare multiple lists without credit consumption
  • Pre-Processing Insights: Understand your data before full validation

​
Example Usage

curl -X POST https://base.sanitizeemail.com/v1/api/filesupload/analyze-list/ \
  -H "X-API-KEY: YOUR_API_KEY" \
  -F "file_id=751" \
  -F "name=Customer List Analysis"

​
Response Format

{
  "file_id": 751,
  "bounce_rate": 66.67,
  "status": "analyzed"
}

​
Important Notes

Approximation Method: This endpoint uses intelligent sampling techniques to provide bounce rate estimates. While results are close to actual values, they are approximations and may vary from precise validation results.
Zero Cost Analysis: Perfect for getting insights into your email list quality without spending credits. Use this before deciding whether to proceed with full validation.
Not 100% Accurate: Results are estimates based on analysis patterns. For exact validation results, use the Clean Email List endpoint.

​
When to Use This vs Full Validation

Use Analyze List WhenUse Full Validation When
Quick quality check neededExact results required
Budget planningPreparing final email campaigns
Comparing multiple listsCompliance requirements
Initial assessmentProduction email sends

​
Prerequisites

File Upload Required: You must first upload a file using the /v1/api/filesupload/ endpoint to obtain the required file_id.

Authorizations

​
X-API-KEY
string
header
required

API key for authentication

Body

multipart/form-data

Email list analysis request payload

​
file_id
integer
required

ID of the uploaded file (obtained from file upload response)

Example:

751

​
name
string

Name for the analysis request

Example:

"Customer List Analysis"

Response

Email list analysis completed successfully

​
file_id
integer

ID of the analyzed file

​
bounce_rate
number<float>

Estimated bounce rate percentage

​
status
enum<string>

Analysis completion status

Available options:
analyzed