Quick Start

Make your first request

Sign up for UserCheck and get your API key.

Check out the Authentication page to see how to identify your requests.

To make your first request, send a GET request to the domain endpoint.

Check a domain

GET https://api.usercheck.com/domain/example.com

Check the domain example.com.

200 The domain is valid

{
    "status": 200,
    "domain": "example.com",
    "mx": false,
    "disposable": false,
    "public_domain": false,
    "did_you_mean": null
}

400: Bad Request The domain is invalid

{
    "status": 400,
    "error": "The domain is invalid."
}

429: Too Many Requests Rate limit exceeded

{
    "status": 429,
    "error": "Too many requests"
}

Explore the domain endpoint in details or try our email endpoint.

Take a look at how you might call our API using different languages:

cURL

curl https://api.usercheck.com/domain/example.com

PHP (cURL)

$domain = "example.com";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.usercheck.com/domain/' . $domain);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);

var_dump($response);

PHP (Guzzle)

$domain = "example.com";

$client = new GuzzleHttp\Client;

$guzzle = $client->get("https://api.usercheck.com/domain/" . $domain);

JavaScript

const domain = 'example.com';
var xmlHttp = new XMLHttpRequest();
xmlHttp.open( "GET", "https://api.usercheck.com/domain/" + domain, false );
xmlHttp.send();
console.log(xmlHttp.responseText);