Quick Start

Make your first request

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);