API v2 Documentation


DNS History Request

http://api.completedns.com/v2/dns-history/youtube.com?key=YOUR_API_KEY
You can find the API key in your account, in the API section.

Response

Headers
Cache-Control:no-cache
Connection:close
Content-Type:application/json
Date:Mon, 10 Oct 2016 20:20:56 GMT
Host:api.completedns.com
reports-left:994
Response
{
  "domain": "youtube.com",
  "drops": 0,
  "changes": 6,
  "years": "11",
  "events": [
    ..
    {
      "date": {
        "type": "between",
        "date": null,
        "date_start": "2005-06-02",
        "date_end": "2005-10-01"
      },
      "type": "change",
      "nameservers": [
        "ns1.servepath.com",
        "ns2.servepath.com"
      ],
      "changes": [
        {
          "type": "added",
          "ns": "ns1.servepath.com"
        },
        {
          "type": "added",
          "ns": "ns2.servepath.com"
        },
        {
          "type": "removed",
          "ns": "ns13.worldnic.com"
        },
        {
          "type": "removed",
          "ns": "ns14.worldnic.com"
        }
      ]
    },
    {
      ..
    },
    {
      ..
    },
    ..
  ]
}

response[drops] - number of drops (nameservers removed) recorded

response[changes] - number of change events recorded

response[years] - period in years since start tracking/first change recorded

response[events] - holds the actual change events recorded for the queried domain

Change Event

..
    {
      "date": {
        "type": "between",
        "date": null,
        "date_start": "2005-06-02",
        "date_end": "2005-10-01"
      },
      "type": "change",
      "nameservers": [
        "ns1.servepath.com",
        "ns2.servepath.com"
      ],
      "changes": [
        {
          "type": "added",
          "ns": "ns1.servepath.com"
        },
        {
          "type": "added",
          "ns": "ns2.servepath.com"
        },
        {
          "type": "removed",
          "ns": "ns13.worldnic.com"
        },
        {
          "type": "removed",
          "ns": "ns14.worldnic.com"
        }
      ]
    },
..

response[events][n][date][type]

between: means event is recorded between date_start and date_end and exact date can't be given

exact: means we've recorded the event exactly on date


response[events][n][type]

start_tracking: Domain started tracking

dropped: Domain dropped

created: Domain created

change: Domain nameservers changed


response[events][n][nameservers]

Domain nameservers on that date.


response[events][n][changes]

type: added/removed

ns: nameserver


Error Responses

No API key
{
  "error_type": "no_api_key",
  "error_msg": "You must provide API key in order to make request."
}

API key not valid
{
  "error_type": "api_key_not_valid",
  "error_msg": "API key is not valid."
}

IP not allowed
{
  "error_type": "ip_not_allowed",
  "error_msg": "Your IP is not allowed to maky API calls."
}

Domain not valid
{
  "error_type": "domain_not_valid",
  "error_msg": "Domain name is not valid."
}

TLD not supported
{
  "error_type": "tld_not_supported",
  "error_msg": "Domain TLD is not supported."
}

No reports left
{
  "error_type": "no_reports_left",
  "error_msg": "Your dont have any reports left."
}


Old v1 API