v1

latestSwagger 2.02026-07-172161122.5 KB

Email Verification

Get bulk verification results

Retrieves results or status of bulk verification job

get/verify/v1/email/bulk/results/{requestId}

Path parameters

requestIdstring uuid required

Bulk verification job ID

Response

Verification results or status

estimatedCompletionTsinteger

Estimated completion timestamp required: true

fileNamestring

Original filename required: true

jobIdstring

Unique job identifier required: true format: uuid

messagestring

Progress message required: true

statusstring

Processing status required: true enum: processing,completed

Example response

{
  "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"
}