Batch Analyze Emails
POST/email/batch
The Batch Analyze Emails endpoint enables processing of large volumes of email addresses asynchronously. This endpoint accepts various input formats and returns a job ID for tracking the analysis progress.
Features:
- Asynchronous Processing: Submit large lists of emails for background processing.
- Multiple Input Formats: Submit data as JSON arrays, tabular CSV/TSV/XLSX uploads, or line-separated text.
- Job Tracking: Monitor processing status using the returned job ID.
Example JSON Request:
{
"emails": [
"first-email@domain.com",
"second-email@domain.com"
],
"name": "my list of emails",
"enableAI": true,
"enableAutoCorrection": true
}
Authentication & Security
- API Key: Access requires an API key in the request headers.
- ACL Rules: Optional IP-based access restrictions for enhanced security.
- No Query Parameters: All data is transmitted securely through headers or request body.
Payload Limits
- Maximum payload size: 3MB
Request
Responses
- 202
- 400
- 401
- 402
- 403
- 413
- 429
- 500
Batch job accepted for processing.
Bad Request. Either the request is improperly formatted, or contains invalid data.
Unauthorized. Invalid or missing authentication token.
Plan limitations or quota exceeded.
Forbidden. Authorization errors from the API.
Payload Too Large. The request exceeds the 3MB size limit.
Too Many Requests. Rate limit exceeded.
Internal server error.