SCscrapin
Contact

Verify an email address

Asynchronously checks whether an email address can receive mail and returns valid, risky, invalid or unknown. The request is acknowledged with data.webhookId and data.pollUrl. Poll GET /v2/webhooks/{webhookId} for the verdict in data.result (ContactEmailVerifyResult), or receive it on the optional webhookUrl callback. Credits: 1 per verdict, whatever it says. A check that fails is refunded.

post/v2/contact/email/verify

Request

  • Base URL
    https://api.reversecontact.com
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Optional. A key you choose (1 to 255 printable ASCII characters, a UUID for example) that makes the request safe to retry. For 24 hours, a request with the same key and the same body returns the first response with Idempotent-Replayed: true, without starting another lookup or debiting credits.

Request body

emailstring email required

Email address to verify

webhookUrlstring uri

Optional HTTPS URL for the result callback

Example request

{
  "email": "jane@acme.com"
}

Response

Email verification task created

successtrue required
errorunknown required

Example response

{
  "data": {
    "status": "created"
  }
}

Changes

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