FreeDomain Check API
Get name DNS
GET/names/{name}/dnsNo key
The latest stored DNS reading of one name, with its parking venue.
NS, A, AAAA, CNAME and MX records, whether a website answers, and the parking venue the reading points at. A name the catalog never stored answers 200 with read: false and empty facts, never 404.
AccessNo key. Limited per address; a key adds the paid fields.
BillingOne call.
FormatsJSON
Request
namestringRequiredPathA full domain name on an ending the catalog holds, lowercased, IDN as punycode. A bare word, a subdomain, an e-mail address or an unknown ending answers 400 validation_failed with reason and suggestion.
fieldsstringOptionalQueryComma-separated top-level keys to keep; an unknown key answers 400 unsupported_field.
curl -X GET "https://api.unique.domains/v1/names/get.plumbing/dns"
const response = await fetch("https://api.unique.domains/v1/names/get.plumbing/dns", {
method: "GET",
});
const data = await response.json();
console.log(data);import requests
response = requests.get(
"https://api.unique.domains/v1/names/get.plumbing/dns",
)
print(response.json())req, err := http.NewRequest("GET", "https://api.unique.domains/v1/names/get.plumbing/dns", nil)
if err != nil {
panic(err)
}
res, err := http.DefaultClient.Do(req)$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://api.unique.domains/v1/names/get.plumbing/dns",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($ch);uri = URI("https://api.unique.domains/v1/names/get.plumbing/dns")
request = Net::HTTP::Get.new(uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }Response
readbooleannsstring[]astring[]aaaastring[]cnamestring[]mxobject[]hasWebsiteboolean | nullparkingstring | nullErrors
{
"data": {
"read": true,
"ns": [
"ns6.afternic.com",
"ns5.afternic.com"
],
"a": [
"76.223.54.146",
"13.248.169.48"
],
"aaaa": [],
"cname": [],
"mx": [
{
"exchange": "",
"priority": 0
}
],
"hasWebsite": true,
"parking": "afternic"
},
"meta": {
"asOf": null,
"cursor": null,
"limit": null
},
"links": {
"self": "https://api.unique.domains/v1/names/get.plumbing/dns",
"next": null,
"register": null,
"product": null,
"dataset": null
}
}