sendsend.email
Sign inStart building

Verify up to 100 email addresses

POST/v1/verify/batch

The same checks as verifying one address, for a list of up to 100. Results come back in the order you sent them, with a count of each outcome. Every address uses one verification, and the whole request is refused if your remaining verifications would not cover it.

Required scope: emails:verify

Request body

FieldType
emailsrequiredstring[]

Unknown fields are rejected, so a typo never silently does nothing.

Example

curl -X POST 'https://api.sendsend.email/v1/verify/batch' \
  -H "Authorization: Bearer $SENDSEND_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "emails": [
    "maria@example.com",
    "bad@@example"
  ]
}'

Response 200

{
  "object": "list",
  "data": [
    {
      "object": "email_verification",
      "email": "maria@example.com",
      "result": "valid",
      "reasons": [],
      "suggestion": null,
      "free_provider": false,
      "role_account": false,
      "disposable": false,
      "mail_servers": [
        "mx1.example.com"
      ]
    },
    {
      "object": "email_verification",
      "email": "bad@@example",
      "result": "invalid",
      "reasons": [
        "invalid_syntax"
      ],
      "suggestion": null,
      "free_provider": false,
      "role_account": false,
      "disposable": false,
      "mail_servers": []
    }
  ],
  "summary": {
    "valid": 1,
    "invalid": 1,
    "risky": 0,
    "unknown": 0
  },
  "verifications": {
    "used": 14,
    "limit": 5000
  }
}

Errors

StatusCodeWhen
400validation_errorThe request body or parameters are invalid. The message says which field.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.
429quota_exhaustedThe month’s verifications for your plan would be exceeded.
429rate_limitedToo many requests. Wait for the number of seconds in the Retry-After header.

Every error has the same shape. See Errors.