Email Verification

Verify a list of email addresses (spends money)

SPENDS MONEY: every address checked adds metered usage to the workspace's next invoice. No campaign is created and nothing is sent. Each check runs up to two providers in a waterfall and every provider that returns a verdict is one billable verification credit, so an address costs ONE credit when the first provider rejects it outright and TWO otherwise. Call GET /email-verification/rates for the current per-credit price and use per_address_ceiling_usd to budget. An address that gets no verdict (a provider failure, a cancelled job, or the workspace's monthly verification allowance running out mid-job) is NOT billed and comes back with result unknown, still in the download. Duplicates are removed and unparseable entries are returned in invalid_emails before anything is charged. Requires an active or trialing subscription: a past_due workspace is refused with subscription_not_active, and a trialing workspace may submit up to 100 addresses in total across all its jobs, after which it is refused with trial_allowance_exceeded. Errors carry a machine-readable code: insufficient_allowance (402, with needed_usd and available_usd), trial_allowance_exceeded (402, with allowance and remaining), subscription_not_active (402), no_active_subscription (402) and invalid_request (400).

post/email-verification/jobs

Request

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

Request body

emailsstring[] required

Emails are the addresses to verify. Duplicates are removed before anything is charged, and syntactically invalid entries are returned in invalid_emails rather than billed.

namestring required

Name is what the job is called in the app. Required.

Example request

{
  "emails": [
    "ada@example.com",
    "grace@example.com"
  ],
  "name": "Q3 conference list"
}

Response

The created job and its cost estimate

duplicate_rowsinteger

DuplicateRows is how many repeats were removed. Each one would have been a second paid check for an answer already bought.

estimate_high_usdnumber

EstimateHighUsd assumes every address runs both providers. This is the common case and the number to plan against.

estimate_low_usdnumber

EstimateLowUsd assumes every address settles on the first provider.

idstring

ID of the created job.

invalid_emailsstring[]

InvalidEmails are the submitted entries that are not addresses at all. They were not charged for and are not in the job.

totalinteger

Total is how many addresses were accepted, after removing duplicates and unparseable entries.

Example response

{
  "duplicate_rows": 12,
  "estimate_high_usd": 8.5,
  "estimate_low_usd": 4.25,
  "id": "1234",
  "total": 2500
}

Changes

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