Email Finder

Get Email Finder job results

Retrieve one email finder job by the job_id you got when you created it. This is the polling endpoint for a bulk job, and for a single lookup that answered 202. A single lookup whose credits could not be taken returns 402 instead of its result.

While the job is queued or running you get 202 with its status and progress percentage. Once every prospect has been processed you get 200 with the full result list, each entry carrying the email found and its deliverability verdict. Polling once every few seconds is plenty.

Reading a job is free — the credits for the emails found were already taken when the job finished.

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

Request

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

Path parameters

job_idstring required

Response

OK

idstring required

Identifier of the job, as returned when you created it.

statusstring required

Job status: pending, running, complete or failed.

created_atstring required

When the job was created.

updated_atstring required

When the job last changed.

progressinteger

Percentage of the job's prospects that have finished, from 0 to 100.

prospect_countinteger required

Number of prospects submitted.

error_messagestring

Job-level failure message. Empty when the job itself did not fail; a single prospect failing is reported on that prospect.

job_typestring

Always email_finder for jobs created on this endpoint.

Example response

{
  "id": "dcbcdb01-42a8-4efb-91a7-ce6a9ba01afb",
  "status": "complete",
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:05:00Z",
  "progress": 100,
  "prospect_count": 2,
  "job_type": "email_finder",
  "prospects": [
    {
      "id": "5371cd59-adc2-402f-af02-d40aee34f629",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "company_name": "Example Corp",
      "company_domain": "example.com",
      "found_email": "john.doe@example.com",
      "email_validity": "safe",
      "status": "complete",
      "error_message": "Email not found"
    }
  ],
  "write_back": [
    {
      "status": "completed"
    }
  ]
}

Changes

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