GET
/
verify
/
v1
/
email
/
bulk
/
results
/
{requestId}
curl --request GET \
  --url https://api.customeros.ai/verify/v1/email/bulk/results/{requestId} \
  --header 'X-CUSTOMER-OS-API-KEY: <api-key>'
{
  "estimatedCompletionTs": 1694030400,
  "fileName": "emails.csv",
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Completed 1000 of 1000 emails",
  "results": {
    "deliverable": 950,
    "downloadUrl": "https://api.customeros.ai/verify/v1/email/bulk/results/550e8400-e29b-41d4-a716-446655440000/download",
    "totalEmails": 1000,
    "undeliverable": 45
  },
  "status": "completed"
}

Authorizations

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

Path Parameters

​
requestId
string
required

Bulk verification job ID

Response

200
application/json
Verification results or status

Response containing bulk verification results or status

​
estimatedCompletionTs
integer

Estimated completion timestamp required: true

Example:

1694030400

​
fileName
string

Original filename required: true

Example:

"emails.csv"

​
jobId
string

Unique job identifier required: true format: uuid

Example:

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

​
message
string

Progress message required: true

Example:

"Completed 1000 of 1000 emails"

​
results
object

Verification results if completed required: false

​
status
string

Processing status required: true enum: processing,completed

Example:

"completed"