Email Validation: per-result callback

Webhook

POST

emailValidationResult

Your server receives this POST once for every email in a batch validation
job. It fires as soon as each individual email finishes validation, so you can
process results in real time without waiting for the full batch.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Return any 2xx to acknowledge receipt

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://your-api-server.com' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "webhook:email_lookup.completed",
    "timestamp": "2025-06-03T14:35:00.000Z",
    "data": {
        "job_id": "665a1f4e2c3b7800129dce01",
        "result_id": "sarah.chen@stripe.com",
        "result": {
            "email": "sarah.chen@stripe.com",
            "result": "valid",
            "message": "The mailbox exists and is accepting mail",
            "provider": "GOOGLE",
            "confidence": "high",
            "is_catch_all": false,
            "domain": "stripe.com"
        }
    }
}'

Modified at 2026-02-07 15:01:45

Cancel a pending invitation

Email Validation: batch completion callback