API Reference

Definitions of the email-verifier payloads you will receive on your webhook endpoint

1. "verification_finished" payload

{
  "event": "verification_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
	"email": "[email protected]",
  "qualification": "valid",
  "custom": "your_custom_data"
}

ℹ️ Since you receive the full verification result directly in the webhook notification, this removes the need to perform a GET request to fetch it.


2. "bulk_verification_finished" payload

{
  "event": "bulk_verification_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
  "credits": {
    "cost": 386.25
  }
}

Once you receive a "bulk_verification_finished" payload, request the /email/verify/bulk endpoint with the corresponding id to get the verification results.
This allows for perfect live-retrieval of your results.