Email validation (batch)

Validate up to 50 email addresses. The same checks for up to 50 addresses in one call, with one DNS lookup per distinct domain. Results keep the input order; summary counts the verdicts.

Cost

Credits: 5 per address ($0.0005 per address). 50 credits are reserved before the call; the call is then settled on the real number of items returned. Failed calls are free. Source price: bulk-email-validator/email-validated.

Input

Send a JSON body (POST) or the same fields as a query string (GET).

Required: emails.

Examples

Replace tt_live_XXXX with your key from the pricing page.

curl

curl -i -X POST "https://tools.yukai.uk/api/v1/email/validate/batch" \
  -H "Authorization: Bearer tt_live_XXXX" \
  -H "Content-Type: application/json" \
  -d '{"emails":["jane@gmail.com","info@stripe.com"]}'

JavaScript (fetch)

const res = await fetch("https://tools.yukai.uk/api/v1/email/validate/batch", {
  method: "POST",
  headers: { "Authorization": "Bearer tt_live_XXXX", "Content-Type": "application/json" },
  body: JSON.stringify({"emails":["jane@gmail.com","info@stripe.com"]}),
});
console.log(res.status, res.headers.get("x-credits-charged"), res.headers.get("x-credits-balance"));
console.log(await res.json());

Python (requests)

import requests

r = requests.post(
    "https://tools.yukai.uk/api/v1/email/validate/batch",
    headers={"Authorization": "Bearer tt_live_XXXX"},
    json={"emails": ["jane@gmail.com", "info@stripe.com"]},
    timeout=120,
)
print(r.status_code, r.headers.get("x-credits-charged"), r.headers.get("x-credits-balance"))
print(r.json())

Response

JSON with "success": true and the result fields; on failure {"success": false, "error": {"code", "message", "retryable"}} and no credits are used. Every answer carries x-credits-charged (credits used) and x-credits-balance (balance after the call); check the balance any time with GET https://tools.yukai.uk/v1/billing/balance.

Full field list and response schema: OpenAPI spec email-validation (its servers entry is the marketplace gateway; call https://tools.yukai.uk with your key).

← All routes · Pricing