Misc Domain API

The Misc Domain API provides helper endpoints to resolve MX and Whois records for any domain, so you can quickly check where email for a domain is hosted, validate domain ownership, and enrich leads or accounts with reliable domain metadata inside your workflows

Find MX

post

Convenience API to find and return the MX records for domain in higher priority order

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Find MX records for domain

Example: gmail.com

timeoutnumberOptional

Request wait time (in milliseconds), Maximum allowed wait time should not exceed 110000 milliseconds

Default: 90000Example: 90000

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

524

Timeout Occurred

application/json

post

/domain/resolve/mx

HTTPcURLJavaScriptPython

POST /v2/domain/resolve/mx HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "domain": "gmail.com",
  "timeout": 90000
}

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "domain": "gmail.com",
    "mx_records": [
      {
        "exchange": "gmail-smtp-in.l.google.com",
        "priority": 5
      },
      {
        "exchange": "alt1.gmail-smtp-in.l.google.com",
        "priority": 10
      },
      {
        "exchange": "alt2.gmail-smtp-in.l.google.com",
        "priority": 20
      },
      {
        "exchange": "alt3.gmail-smtp-in.l.google.com",
        "priority": 30
      },
      {
        "exchange": "alt4.gmail-smtp-in.l.google.com",
        "priority": 40
      }
    ],
    "verified_on": "2020-11-17T04:17:45.473Z",
    "time_taken": 3
  }
}

Find Whois

post

Convenience API to find and return the Whois record for domain in JSON format

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Find Whois record for domain

Example: apple.com

timeoutnumberOptional

Request wait time (in milliseconds), Maximum allowed wait time should not exceed 110000 milliseconds

Default: 90000Example: 90000

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

524

Timeout Occurred

application/json

post

/domain/resolve/whois

HTTPcURLJavaScriptPython

POST /v2/domain/resolve/whois HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "domain": "apple.com",
  "timeout": 90000
}

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "domain": "apple.com",
    "whoisRecord": {
      "domain": {
        "name": "apple.com",
        "id": "1225976_DOMAIN_COM-VRSN",
        "status": {
          "clientTransferProhibited": "http://www.icann.org/epp#clientTransferProhibited",
          "serverDeleteProhibited": "http://www.icann.org/epp#serverDeleteProhibited",
          "serverTransferProhibited": "http://www.icann.org/epp#serverTransferProhibited",
          "serverUpdateProhibited": "http://www.icann.org/epp#serverUpdateProhibited"
        },
        "created_date": "1987-02-19T04:00:00.000Z"
      },
      "registrar": {
        "name": "CSC CORPORATE DOMAINS, INC.",
        "whois_server": "whois.corporatedomains.com",
        "url": "www.cscprotectsbrands.com",
        "registration_expiry_date": "2021-02-20T04:00:00.000Z",
        "abuse_contact_email": "[email protected]",
        "abuse_contact_phone": "+1.8887802723"
      },
      "registrant": {
        "id": "",
        "name": "Domain Administrator",
        "organization": "Apple Inc.",
        "steet": "",
        "city": "Cupertino",
        "state": "",
        "postal_code": "95014",
        "country": "US",
        "phone": "+1.4089961010",
        "phone_ext": "",
        "fax": "+1.4089741560",
        "fax_ext": "",
        "email": "[email protected]",
        "admin": {
          "id": "",
          "name": "Domain Administrator",
          "organization": "Apple Inc.",
          "steet": "",
          "city": "Cupertino",
          "state": "",
          "postal_code": "95014",
          "country": "US",
          "phone": "+1.4089961010",
          "phone_ext": "",
          "fax": "+1.4089741560",
          "fax_ext": "",
          "email": "[email protected]"
        },
        "tech": {
          "id": "",
          "name": "Domain Administrator",
          "organization": "Apple Inc.",
          "steet": "",
          "city": "Cupertino",
          "state": "",
          "postal_code": "95014",
          "country": "US",
          "phone": "+1.4089961010",
          "phone_ext": "",
          "fax": "+1.4089741560",
          "fax_ext": "",
          "email": "[email protected]"
        }
      },
      "dnssec": "unsigned",
      "nameservers": [],
      "notice": "You are not authorized to access or query our WHOIS database through the use of high-volume, automated, electronic processes or for the purpose or purposes of using the data in any manner that violates these terms of use. The Data in the CSC WHOIS database is provided by CSC for information purposes only, and to assist persons in obtaining information about or related to a domain name registration record. CSC does not guarantee its accuracy. By submitting a WHOIS query, you agree to abide by the following terms of use",
      "term_of_use": "",
      "last_update_whois_database": ""
    },
    "verified_on": "2020-11-17T04:15:51.692Z",
    "time_taken": 687
  }
}