Skip to content

Validate a single email address

POST
/api/email/validate

Comprehensive email validation including RFC compliance, DNS checks, and blocklist validation. Results are cached for performance.

object
email
required

The email address to validate

string format: email
<= 254 characters
Example

Email validation completed successfully

object
success
boolean
Example
true
data

Email validation result with comprehensive checks

object
email

The validated email address

string
Example
is_valid

Whether the email passed all validation checks

boolean
Example
true
error

Error message if validation failed

string
nullable
warnings

Array of validation warnings

Array<string>
Example
[]
cached

Whether result was served from cache

boolean
validated_at

ISO timestamp of validation

string
Example
2024-01-01T12:00:00Z
is_spamtrap

Whether email is identified as likely spamtrap

boolean
spamtrap_score

Spamtrap probability score (0.0-1.0)

number format: float
<= 1
Example
0.1

Invalid request parameters

object
success
boolean
message
string
Example
The given data was invalid.
errors
object

Unauthorized - Invalid or missing authentication

object
success
boolean
message
string
Example
Unauthorized

Rate limit exceeded

object
success
boolean
message
string
Example
Rate limit exceeded. Please try again later.
retry_after

Seconds until rate limit resets

integer
Example
3600
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Maximum requests per hour

X-RateLimit-Remaining
integer

Remaining requests in current window

Internal server error

object
success
boolean
message
string
Example
Internal server error occurred during email validation