Validate email

There is only one endpoint for this API. It contains all the information you need to successfully validate an email address. The response object includes numerous fields, but you should primarily focus on the valid field. As shown in your dashboard, some fields are configurable, and these configurations directly affect the result of the valid field.

POST
https://api.realmail.dev/v1/validate
curl --location 'https://api.realmail.dev/v1/validate' --header 'x-api-key: YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{
  "email": "email@domain.com"
}'
  
{
    "data": {
        "valid_email_format": true,
        "suggestion": null,
        "mx_found": true,
        "has_active_website": true,
        "is_disposable": false,
        "is_suspected_role": false,
        "free_email_provider": false,
        "reason_code": null,
        "reason_message": null,
        "valid": true,
        "remaining_validations": 15703
    }
}

Request

Headers

x-api-key
string
required
API key for authentication. You can find your API key and create a new one in your account settings.
Content-Type
string
required
Content type of the request: application/json

Body

email
string
required
Email address to validate

Response

Success

email
string
Validated email address
valid_email_format
boolean
Indicates if the email address has a valid format acording to RFC 5322.
suggestion
string
Suggested email address. If a possible typo is detected a suggestion will be displayed. Only applies to the domain.
mx_found
boolean
Indicates if the domain has a valid MX record.
has_active_website
boolean
Indicates if the domain has an active website.
is_disposable
boolean
Indicates if the email address is a temporary or disposable email address like mailinator.com, 10minutesmail, etc.
is_suspected_role
boolean
Indicates if the email address is a suspected role email address like admin@example.com, support@example.com, etc.
free_email_provider
boolean
Indicates if the email address is from a free email provider like Gmail, Outlook, etc.
valid
boolean
Indicates if the email address is valid. If the email address is invalid, the reason code will be returned. It is possible to change the values affecting the validation result through the application.
reason_code
string
Reason code for the validation.
reason_message
string
Validation reason message. It can be set up through the application.
remaining_validations
number
Remaining validations for the organization.

Error

name
string
Error name. Available values: ApiKeyError, ValidationError, QuotaExceededError, RateLimitError, ServerError, UnexpectedError
message
string
Error message detailed information.
code
number
Error code. Available values: 400, 401, 403, 429, 500, 503, 504