API v2 Documentation

Authentication

Append your API key as a query parameter to every request. You can find your key in the API section of your account.

DNS History Request

GET https://api.completedns.com/v2/dns-history/youtube.com?key=YOUR_API_KEY

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 Body

{
  "domain": "youtube.com",
  "drops": 0,
  "changes": 6,
  "years": "11",
  "was_parked": "0",
  "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 Fields

Field	Description
`domain`	The queried domain name
`drops`	Number of drops (nameservers removed) recorded
`changes`	Number of change events recorded
`years`	Period in years since first change recorded
`was_parked`	Whether the domain was parked before
`events`	Array of change events recorded for the domain

Event Object

Field	Description
`date.type`	between — event occurred between `date_start` and `date_end` exact — event recorded exactly on `date`
`type`	`start_tracking` · `dropped` · `created` · `change`
`nameservers`	Domain nameservers on that date
`changes`	Array of changes — each with `type` (`added` / `removed`) and `ns` (nameserver)

Error Responses

All errors return a JSON object with error_type and error_msg fields.

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 / quota left

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