Get batch validation results

GET

/email-validation/batch/{batchId}/results

Fetch the results once your batch has finished. Results are paginated — use
page and limit to walk through them.

Credit settlement: The first time you call this after the batch reaches
completed or failed, we calculate the final cost and refund any excess
credits. Subsequent calls return the cached settlement.

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 ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Paginated validation results

Body

🟠401Unauthorized

🟠404Not Found

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://dev.enrich.so/api/v3/email-validation/batch/665a1f4e2c3b7800129dce01/results?page&limit' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "batchId": "665a1f4e2c3b7800129dce01",
        "status": "completed",
        "totalItems": 4,
        "processedCount": 4,
        "results": [
            {
                "email": "sarah.chen@stripe.com",
                "result": "valid",
                "message": "The mailbox exists and is accepting mail",
                "isCatchAll": false,
                "provider": "GOOGLE",
                "confidence": "high"
            },
            {
                "email": "james.rodriguez@hubspot.com",
                "result": "valid",
                "message": "The mailbox exists and is accepting mail",
                "isCatchAll": false,
                "provider": "MICROSOFT",
                "confidence": "definitive"
            },
            {
                "email": "priya.patel@notion.so",
                "result": "invalid",
                "message": "The mailbox does not exist on this server",
                "isCatchAll": false,
                "provider": "GOOGLE",
                "confidence": "definitive"
            },
            {
                "email": "marco.silva@datadog.com",
                "result": "risky",
                "message": "The domain accepts all addresses (catch-all) so delivery cannot be guaranteed",
                "isCatchAll": true,
                "provider": "SMTP",
                "confidence": "low"
            }
        ]
    },
    "meta": {
        "requestId": "665a23bc2c3b7800129dce10",
        "creditsUsed": 2,
        "creditsRefunded": 2,
        "creditsRemaining": 24997,
        "totalItems": 4,
        "processedItems": 4
    }
}

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

Check batch validation progress

Find a professional email