WHOIS API
Read the registry record of a domain name as JSON: registrar, creation and expiry dates, status codes, name servers, DNSSEC and holder. Every record comes back in the same shape on every ending.
- Without a key: the registry record of one name.
- The record's history, with its past versions, registrar moves and lock removals, needs a paid RapidAPI subscription or the Investor plan.
- Free calls need no key: 60 calls an hour and 100 a day from one address.
Try it
curl -X GET "https://api.unique.domains/v1/names/get.plumbing/registry"
const response = await fetch("https://api.unique.domains/v1/names/get.plumbing/registry", {
method: "GET",
});
const data = await response.json();
console.log(data);import requests
response = requests.get(
"https://api.unique.domains/v1/names/get.plumbing/registry",
)
print(response.json())req, err := http.NewRequest("GET", "https://api.unique.domains/v1/names/get.plumbing/registry", 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/registry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($ch);uri = URI("https://api.unique.domains/v1/names/get.plumbing/registry")
request = Net::HTTP::Get.new(uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }{
"data": {
"read": true,
"observedOn": "2026-09-23",
"createdAt": "2020-06-03T08:30:53.000Z",
"updatedAt": "2026-08-12T04:41:40.000Z",
"expiresAt": "2027-06-03T08:30:53.000Z",
"registryUpdatedAt": "2026-10-22T13:39:28.000Z",
"registrar": {
"name": "GoDaddy.com, LLC",
"ianaId": 146,
"url": null
},
"eppStatuses": [
{
"id": "clientDeleteProhibited",
"raw": "clientDeleteProhibited"
},
{
"id": "clientRenewProhibited",
"raw": "clientRenewProhibited"
},
{
"id": "clientTransferProhibited",
"raw": "clientTransferProhibited"
},
{
"id": "clientUpdateProhibited",
"raw": "clientUpdateProhibited"
}
],
"nameservers": [
"ns5.afternic.com",
"ns6.afternic.com"
],
"dnssec": false,
"holder": {
"holder": null,
"redactedBy": null,
"heldAtRegistrar": true
},
"transport": "rdap"
},
"meta": {
"asOf": null,
"cursor": null,
"limit": null
},
"links": {
"self": "https://api.unique.domains/v1/names/get.plumbing/registry",
"next": null,
"register": null,
"product": null,
"dataset": null
}
}Endpoints
/names/{name}/registryThe registry record of one name: dates, registrar, status codes, nameservers, DNSSEC and holder.FreeGET/names/{name}/registry/historyThe past versions of one name's registry record and what moved between them.PaidWays to call it
npm install @uniquedomains/whoisnpx @uniquedomains/whois get.plumbingWHOIS API questions
Contact meIs this WHOIS API free?
The registryRegistryThe organisation that runs an ending, like the company behind .com. It sets the rules and the price registrars pay.Read the definition record of a name is free: no key, 60 calls an hour and 100 a day from one address. The record's history needs a paid RapidAPI subscription to the WHOISWHOISThe public record of who registered a domain and when. Most owner contact detail is hidden by privacy rules, but the dates are not.Read the definition Lookup API, or a member key on the Investor plan.
What does a name outside the catalog return?
200 with empty facts and read set to false, never a 404.
Does it cover endings that answer over RDAP only?
Yes. A registryRegistryThe organisation that runs an ending, like the company behind .com. It sets the rules and the price registrars pay.Read the definition answers over WHOISWHOISThe public record of who registered a domain and when. Most owner contact detail is hidden by privacy rules, but the dates are not.Read the definition, over RDAPRDAPThe modern replacement for WHOIS. Registries answer it with the same registration facts in a form built for machines to read.Read the definition or both, and the record has the same fields either way: registrarRegistrarThe company you buy and renew a domain through, such as Namecheap or GoDaddy. It does not own the name, it only registers it for you.Read the definition, dates, status codesStatus codesShort codes the registry puts on a name to say what can and cannot be done with it, like a block on transfers.Read the definition, name servers, DNSSECDNSSECA signature on a domain’s answers that proves nobody changed them on the way.Read the definition and holder. Its transport field names the format.