Email Verification

Get an email verification job

Returns one job's progress and what it has billed so far. Poll this to know when state becomes done.

get/email-verification/jobs/{id}

Request

  • Base URL: https://api.emailchaser.com/r
  • URL: https://api.emailchaser.com/r/email-verification/jobs/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Job ID

Response

The job

catchallinteger

Catchall accepts everything at the domain, so deliverability is likely but not proven.

end_timestring

EndTime in RFC3339, zero while the job is still running.

error_codestring

ErrorCode is empty on a healthy job. monthly_limit_reached means the allowance ran out and the remaining addresses came back unknown rather than missing; they are still in the download, marked.

idstring
invalidinteger

Invalid will bounce.

meter_eventsinteger

MeterEvents is what the job has billed so far. Every check runs up to two providers and each one that answers is one event, so an address costs one event or two.

namestring

Name the job was created with.

processedinteger

Processed is how many have a verdict yet.

spent_usdnumber

SpentUsd is MeterEvents priced at the meter rate: what this job adds to the invoice, not an estimate.

start_timestring

StartTime in RFC3339.

statestring

State is pending, running, done, failed or canceled.

totalinteger

Total addresses in the job.

unknowninteger

Unknown got no verdict, so it was NOT billed. Usually a provider failure or the workspace's monthly verification allowance running out mid-job, in which case error_code says which.

validinteger

Valid is deliverable.

Example response

{
  "catchall": 400,
  "end_time": "2026-09-10T09:14:00Z",
  "id": "1234",
  "invalid": 280,
  "meter_events": 3100,
  "name": "Q3 conference list",
  "processed": 1800,
  "spent_usd": 5.27,
  "start_time": "2026-09-10T09:00:00Z",
  "state": "running",
  "total": 2500,
  "unknown": 20,
  "valid": 1100
}

Changes

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