POST
/
verify
/
v1
/
email
/
bulk
curl --request POST \
  --url https://api.customeros.ai/verify/v1/email/bulk \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-CUSTOMER-OS-API-KEY: <api-key>' \
  --form 'emailColumn=first column' \
  --form verifyCatchAll=true
{
  "estimatedCompletionTs": 1694030400,
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "File uploaded successfully",
  "resultUrl": "https://api.customeros.ai/verify/v1/email/bulk/results/550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

​
X-CUSTOMER-OS-API-KEY
string
header
required

Body

multipart/form-data
​
file
file
required

CSV file containing email addresses

​
emailColumn
string
default:first column

CSV column containing emails

​
verifyCatchAll
boolean
default:true

Verify catch-all domains

Response

200
application/json
Bulk verification initiated

Response after initiating bulk email verification

​
estimatedCompletionTs
number

Estimated completion timestamp required: true

Example:

1694030400

​
jobId
string

Unique job identifier required: true format: uuid

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
message
string

Status message required: true

Example:

"File uploaded successfully"

​
resultUrl
string

URL to check verification results required: true format: uri

Example:

"https://api.customeros.ai/verify/v1/email/bulk/results/550e8400-e29b-41d4-a716-446655440000"