Get DNS Whois

GET /whois/dns

Gets the DNS Whois information for the given domain. Returns the information if successful, otherwise returns an error.

Permissions Required: Whois::DNS

Headers

  • x-domain string

    The domain to get the DNS Whois information for

Responses

  • 200 application/json

    The DNS Whois information for the given domain

    Hide response attributes Show response attributes object

    The DNS Data returned by the Whois DNS endpoint

    • A string Required

      The A record

    • AAAA string Required

      The AAAA record

    • CAA array[object] Required

      The CAA records

      The CAA record of the Whois DNS

      One of:
      WhoisDNSCAAIODEFRecord object WhoisDNSCAAIssuerRecord object
    • CNAME string Required

      The CNAME record

    • MX array[object] Required

      The MX records

      Hide MX attributes Show MX attributes object

      The MX record of the Whois DNS

      • priority number Required

        The priority of the MX record

      • exchange string Required

        The exchange of the MX record

    • NS array[string] Required

      The NS records

    • PTR array[string] Required

      The PTR records

    • SOA object Required

      The SOA record

      Hide SOA attributes Show SOA attributes object
      • nsname string Required

        The Primary Name Server of the SOA record

      • hostmaster string Required

        The hostmaster of the SOA record

      • serial number Required

        The serial of the SOA record

      • refresh number Required

        The refresh time of the SOA record

      • retry number Required

        The retry time of the SOA record

      • expire number Required

        The expire time of the SOA record

      • minttl number Required

        The minimum TTL (Time-To-Live) of the SOA record

    • SRV array[string] Required

      The SRV record
  • 400 application/json

    Missing domain information

    Hide response attributes Show response attributes object

    The error data that is returned when an error occurs

    All Error Codes are located in /functions/errorResponse.js GitHub

    • code integer Required

      The error code

      Minimum value is 0, maximum value is 30.

    • message string Required

      The error message
  • 401 application/json

    Invalid/Missing API Token

    Hide response attributes Show response attributes object

    The error data that is returned when an error occurs

    All Error Codes are located in /functions/errorResponse.js GitHub

    • code integer Required

      The error code

      Minimum value is 0, maximum value is 30.

    • message string Required

      The error message
  • 403 application/json

    Missing Permissions

    Hide response attributes Show response attributes object

    The error data that is returned when an error occurs

    All Error Codes are located in /functions/errorResponse.js GitHub

    • code integer Required

      The error code

      Minimum value is 0, maximum value is 30.

    • message string Required

      The error message
GET /whois/dns 
curl \
 -X GET https://thefemdevs.com/api/whois/dns \
 -H "x-domain: thefemdevs.com"
Response examples (200) 
{
  "A": "216.24.57.1",
  "MX": [
    {
      "exchange": "mx1.forwardemail.net",
      "priority": 10
    },
    {
      "exchange": "mx2.forwardemail.net",
      "priority": 10
    }
  ],
  "NS": [
    "otto.ns.cloudflare.com",
    "maxine.ns.cloudflare.com"
  ],
  "CAA": [
    {
      "main": true,
      "wild": true,
      "issuer": "comodoca.com"
    },
    {
      "main": true,
      "wild": true,
      "issuer": "digicert.com; cansignhttpexchanges=yes"
    },
    {
      "main": true,
      "wild": true,
      "issuer": "letsencrypt.org"
    },
    {
      "main": true,
      "wild": true,
      "issuer": "pki.goog; cansignhttpexchanges=yes"
    },
    {
      "iodef": "mailto:admin@thefemdevs.com"
    }
  ],
  "PTR": [],
  "SOA": {
    "retry": 2400,
    "expire": 604800,
    "minttl": 3600,
    "nsname": "maxine.ns.cloudflare.com",
    "serial": 2337847618,
    "refresh": 10000,
    "hostname": "dns.cloudflare.com"
  },
  "SRV": [],
  "TXT": [
    "MS=ms65022032",
    "forward-email-site-verification=wS0G9jNYte",
    "v=spf1 a include:spf.forwardemail.net -all",
    "Probely=e85c9999-19d4-4716-9ee7-609f74a9ce3f",
    "google-site-verification=XuaaPNYTdBARR5O3md_9vZhFJDR98v66oKNOWVfRIEY"
  ],
  "AAAA": "",
  "CNAME": ""
}
Response examples (400) 
{
  "code": 8,
  "message": "Missing Header Parameter(s)"
}
{
  "code": 9,
  "message": "Invalid Header Parameter(s)"
}
Response examples (401) 
{
  "code": 3,
  "message": "No API key provided"
}
{
  "code": 4,
  "message": "Invalid API key provided"
}
Response examples (403) 
{
  "code": 1,
  "message": "You are not authorized to access this resource"
}
{
  "code": 2,
  "message": "You are blacklisted from accessing this resource"
}