Skip to content
POST/verify/batch

Verify up to 100 addresses in one call

Verifies up to 100 addresses concurrently and returns per-address results plus a summary count by verdict.

Priced per batch rather than per address, so a full batch costs half the single-address rate.

$0.15 per call120 req/minFree allowance applies

Request

curl -X POST "https://www.twotic.dev/v1/email-verify/verify/batch" \
  -H "Authorization: Bearer $TWOTIC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "emails": [ "dana@example.com", "info@example.com", "user@gmial.com" ] }'

Request body

application/json · required

{
  "emails": [
    "dana@example.com",
    "info@example.com",
    "user@gmial.com"
  ]
}

Response

200Results for every address submitted.
{
  "count": 3,
  "results": [
    {
      "email": "dana@example.com",
      "score": 95,
      "verdict": "deliverable"
    },
    {
      "email": "info@example.com",
      "score": 55,
      "verdict": "risky"
    },
    {
      "email": "user@gmial.com",
      "score": 35,
      "verdict": "risky",
      "didYouMean": "user@gmail.com"
    }
  ],
  "summary": {
    "risky": 2,
    "deliverable": 1,
    "undeliverable": 0
  }
}
400The body is missing, empty, or contains more than 100 addresses.
{
  "error": "too_many_emails",
  "message": "A batch may contain at most 100 addresses."
}

As an agent tool

Connect https://www.twotic.dev/api/mcp/email-verify and this endpoint is exposed as the tool email-verify_verify-batch.

Verify up to 100 email addresses in a single call, returning a per-address verdict plus counts by verdict. Choose this over the single verify tool whenever you have more than a few addresses — cleaning a mailing list, importing contacts, or auditing a CRM. Send a JSON body of {"emails": [...]}, maximum 100 entries.