/v1/bulk
Initiate a bulk email verification.
Authorizations
Body
inputstring[]Required
A list of emails to verify.
Responses
200
OK
application/json
post
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": {}
}
}
}
200
OK
{
"job_id": 1
}
Retrieve the progress of a bulk verification job.
Authorizations
Path parameters
job_idintegerRequired
The unique bulk verification job ID
Responses
200
OK
application/json
get
GET /v1/bulk/{job_id} HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*
200
OK
{
"job_id": 1,
"created_at": "2025-06-26T16:43:50.383Z",
"finished_at": "2025-06-26T16:43:50.383Z",
"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.
Authorizations
Path parameters
job_idstringRequired
The unique bulk verification job ID
Query parameters
limitintegerOptionalDefault:
The number of results to return.
50
offsetintegerOptional
The offset from which to return the results, equivalent to the number of elements in the array to skip.
Responses
200
OK
application/json
get
GET /v1/bulk/{job_id}/results HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*
200
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