Email Validation: batch completion callback

Webhook

POST

emailValidationCompletion

Your server receives this POST exactly once when every email in the
batch has been processed. Use it to trigger downstream workflows like
exporting results or notifying your users.

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": "validation.completed",
    "timestamp": "2025-06-03T14:40:00.000Z",
    "data": {
        "job_id": "665a1f4e2c3b7800129dce01",
        "status": "completed",
        "total_items": 4,
        "successful": 3,
        "failed": 1,
        "completed_at": "2025-06-03T14:40:00.000Z",
        "valid": 2,
        "invalid": 1,
        "risky": 1
    }
}'

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

Email Validation: per-result callback

Email Finder: per-result callback