Email Verifier

Get email validation job results

Retrieve one bulk email-verification job, using the job_id returned when you created it.

This is the polling endpoint. While the job is still queued or running it returns 202 with the current status and progress; once every address has been processed it returns 200 with the full list of verdicts. Poll every few seconds, or supply a webhook_url at creation time and skip polling altogether. It also serves a single verification that answered 202; one whose credits could not be taken returns 402 instead of its verdict.

Synchronous and free: reading a job costs no credits. The credits for the addresses verified were charged when the job completed.

get/v1/email-validation/{job_id}/

Request

  • Base URL: https://api.evaboot.com
  • URL: https://api.evaboot.com/v1/email-validation/{job_id}/
  • Auth: HTTP bearer

Path parameters

job_idstring required

Response

OK

idstring required

Identifier of the job.

statusstring required

complete when every address has been processed, failed when the job could not finish.

created_atstring required

When the job was created.

updated_atstring required

When the job last changed.

progressinteger

Percentage of addresses processed, from 0 to 100.

error_messagestring

Why the job failed. Empty when it completed normally.

job_typestring

Always email_validation for jobs created here.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "complete",
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:05:00Z",
  "progress": 100,
  "prospects": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "email": "john.doe@example.com",
      "email_validity": "safe",
      "status": "complete",
      "error_message": "Invalid email domain"
    }
  ],
  "job_type": "email_validation",
  "write_back": [
    {
      "status": "completed"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.