Validate Email Documentation

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

string

required

Email address to validate

Response

Success

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

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
    }
}