Email Checker API Documentation

Get Report on Email

Cost: 1 credit(s) per call

Endpoint

GET /v1/email/check/{email}

The Email Checker API helps you determine whether an email address is real, safe to accept, or likely to be disposable. It's a great addition to signup forms, lead validation, and anywhere you want to cut down on fake or temporary emails.

When a request is made, the API performs several behind-the-scenes checks: it confirms the domain exists and resolves via DNS, checks for valid MX records, and looks up whether the domain is associated with a disposable provider. It also detects free email services like Gmail or Yahoo.

Finally, you'll get a simple safe flag to help you decide whether to trust the email at a glance. Everything is returned as structured JSON, ready to use in your workflow. The safe flag will indicate if the email exists and is not disposable.

You can use the normalized parameter to get a cleaned version of the email address. — removing +aliases usually used to spam signups with a single email address or disregarded dots used in the usernames of some email services (e.g. Gmail).

Parameters

Header	In	Type	Required	Description
`Authorization`	header	string	Yes	API Key from your console.
`Content-Type`	header	string	Yes	Must be `application/json`.
`email`	path	string	Yes	The full e-mail address to check (e.g. `[email protected]`).

JSON Response

{
    "real_domain": true,
    "mx": true,
    "mx_records": [
        "mx1.mailserver.com.",
        "mx2.mailserver.com."
    ],
    "dns_resolving": true,
    "disposable": false,
    "free": true,
    "normalized": "[email protected]",
    "safe": true
}

Response Fields

Field	Type	Description
`real_domain`	`boolean`	Indicates if the email domain exists and resolves via DNS.
`mx`	`boolean`	`true` if the domain has valid MX (Mail Exchange) records.
`mx_records`	`string[]`	A list of MX record hostnames (e.g., mail servers) associated with the domain.
`dns_resolving`	`boolean`	Indicates if DNS resolution was successful for the domain.
`disposable`	`boolean`	`true` if the domain is recognized as a disposable (temporary) email provider.
`free`	`boolean`	`true` if the domain belongs to a known free email provider (e.g., Gmail).
`normalized`	`string`	The normalized version of the email address, with `+suffix` removed from the username.
`safe`	`boolean`	A high-level safety indicator: `true` if domain is real, has MX, and is not disposable.

Code Snippets

Code ready to go! Select one of your API keys to fill in the code

Note: You can also try it in our API playground



curl -X GET "https://api.wyldapi.com/v1/email/check/[email protected]" \
     -H "Authorization: Bearer <YOUR_TOKEN>"



import requests

url = "https://api.wyldapi.com/v1/email/check/[email protected]"
headers = {
    "Authorization": "Bearer <YOUR_TOKEN>"
}

response = requests.get(url, headers=headers)
print(response.json())



<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://api.wyldapi.com/v1/email/check/[email protected]");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <YOUR_TOKEN>"
]);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));
?>



fetch("https://api.wyldapi.com/v1/email/check/[email protected]", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <YOUR_TOKEN>"
  }
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));