§ Docs · Identity

Email Validation API.

Syntax + MX + disposable + role-based checks.

POST/v1/email-validate Try live → All docs

Authentication

All requests require a bearer token:

Authorization: Bearer tc_live_•••

Get your key from the dashboard. Free tier = 100 calls/month.

Parameters

NameTypeRequiredDescription
email string ✓ Email to validate.

Response

All responses are JSON with snake_case keys. On success, the tool-specific data is returned. On error, the body has at minimum an error field with a human-readable message.

Rate-limit headers are always included:

  • X-RateLimit-Limit — monthly quota
  • X-RateLimit-Remaining — calls left this month
  • X-RateLimit-Reset — Unix timestamp of next reset
  • X-Plan — current plan name
  • X-Request-Id — for support tickets

Errors

StatusWhen
400Missing or invalid parameter (validation failed).
401API key missing or invalid.
403IP not whitelisted, or URL points to a private / metadata address.
429Monthly quota exhausted — see X-RateLimit-Reset.
503Upstream service (worker / search) temporarily unavailable.