Docs › API reference › Email verification

Email verify

Performs a live check against mail servers, so it can take some time when the target mail servers are slow. In some cases it may take up to 60 seconds. For most mail providers it completes in around 2 to 5 seconds.

POSThttps://api.screenlyyid.com/api/v1/email-verify

Headers#

Name	Type	Required	Description
`x-api-key`	string	Yes	Your ScreenlyyID API key
`x-correlation-id`	string (uuid)	No	Correlation ID for this customer check

Request body#

Field	Type	Required	Description
`Email`	string	No
`FixTypos`	boolean	Yes

Responses#

Status	Description
`200`	Successful response

Response body (200)#

Field	Type	Required
`SmtpStatus`	string	No
`DomainError`	boolean	Yes
`Verified`	boolean	Yes
`IsFreemail`	boolean	Yes
`IsDisposable`	boolean	Yes
`Valid`	boolean	Yes
`IsCatchAll`	boolean	Yes
`IsDeferred`	boolean	Yes
`Provider`	string	No
`Domain`	string	No
`SmtpResponse`	string	No
`SyntaxError`	boolean	Yes
`Email`	string	No
`IsPersonal`	boolean	Yes

Code samples#

curl --request POST \
  --url 'https://api.screenlyyid.com/api/v1/email-verify' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-correlation-id: YOUR_CORRELATION_ID' \
  --header 'Content-Type: application/json' \
  --data '{
  "Email": "person@example.com",
  "FixTypos": true
}'

const body = {
  "Email": "person@example.com",
  "FixTypos": true
};

const response = await fetch(
  "https://api.screenlyyid.com/api/v1/email-verify",
  {
    "method": "POST",
    "headers": {
      "x-api-key": "YOUR_API_KEY",
      "x-correlation-id": "YOUR_CORRELATION_ID",
      "Content-Type": "application/json"
    },
    "body": JSON.stringify(body)
  }
);

const result = await response.json();

import requests

payload = {
    "Email": "person@example.com",
    "FixTypos": true
}

response = requests.post(
    'https://api.screenlyyid.com/api/v1/email-verify',
    headers={
        "x-api-key": "YOUR_API_KEY",
        "x-correlation-id": "YOUR_CORRELATION_ID"
    },
    json=payload
)
result = response.json()

using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
client.DefaultRequestHeaders.Add("x-correlation-id", "YOUR_CORRELATION_ID");
var json = @"{
  ""Email"": ""person@example.com"",
  ""FixTypos"": true
}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.screenlyyid.com/api/v1/email-verify", content);
response.EnsureSuccessStatusCode();
var result = await response.Content.ReadAsStringAsync();