/v1/bulk
Initiate a bulk email verification.
A Reacher API key is required for all requests. Sign up on https://reacher.email to get your personal API key.
A list of emails to verify.
OK
POST /v1/bulk HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72
{
"input": [
"text"
],
"webhook": {
"on_each_email": {
"url": "text",
"extra": {}
}
}
}OK
{
"job_id": 1
}Retrieve the progress of a bulk verification job.
A Reacher API key is required for all requests. Sign up on https://reacher.email to get your personal API key.
The unique bulk verification job ID
OK
GET /v1/bulk/{job_id} HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*
OK
{
"job_id": 1,
"created_at": "2025-12-06T01:04:40.795Z",
"finished_at": "2025-12-06T01:04:40.795Z",
"total_records": 1,
"total_processed": 1,
"summary": {
"total_safe": 1,
"total_invalid": 1,
"total_risky": 1,
"total_unknown": 1
},
"job_status": "Running"
}Retrieve the results of a bulk verification job. This endpoint will return an error if the job is still running. Please query GET /v1/bulk/{job_id} first to check the job's progress.
A Reacher API key is required for all requests. Sign up on https://reacher.email to get your personal API key.
The unique bulk verification job ID
The number of results to return.
50The offset from which to return the results, equivalent to the number of elements in the array to skip.
OK
GET /v1/bulk/{job_id}/results HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*
OK
{
"results": {
"input": "[email protected]",
"is_reachable": "invalid",
"misc": {
"is_disposable": true,
"is_role_account": true,
"gravatar_url": "text",
"is_b2c": true
},
"mx": {
"accepts_mail": true,
"records": [
"text"
]
},
"smtp": {
"can_connect_smtp": true,
"has_full_inbox": true,
"is_catch_all": true,
"is_deliverable": true,
"is_disabled": true
},
"syntax": {
"domain": "text",
"is_valid_syntax": true,
"username": "text"
},
"debug": {
"start_time": "text",
"end_time": "text",
"duration": {
"secs": 1,
"nanos": 1
},
"server_name": "text",
"smtp": {
"verif_method": {
"type": "Smtp"
}
}
}
}
}Last updated