FreeDomain Check API

Get name registry

GET/names/{name}/registryNo key

The latest stored registry record of one name: dates, registrar, status codes, nameservers, DNSSEC and holder.

The record's observation time is its UTC day on free (observedOn) and its exact time on keyed (observedAt). transport says whether RDAP or WHOIS answered. A name the catalog never stored answers 200 with tracked: false and empty facts, never 404.

AccessNo key. Limited per address; a key adds the paid fields.

BillingOne call.

FormatsJSON

Connect on RapidAPIAlso inWHOIS Lookup API

Request

namestringRequiredPath

A 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.

fieldsstringOptionalQuery

Comma-separated top-level keys to keep; an unknown key answers 400 unsupported_field.

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) }

Response

readboolean

observedOnstring | null

observedAtstring | null

Keyed.

createdAtstring | null

updatedAtstring | null

expiresAtstring | null

registryUpdatedAtstring | null

registrarobject | null

eppStatusesobject[]

nameserversstring[]

dnssecboolean | null

holderobject

transportstring | null

Errors

validation_failed400

A value is not valid

rate_limited429

Too many requests

internal500

Unexpected error

200 · application/jsonExample

{
  "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
  }
}

Get name registry

Request

Response

Errors

Related endpoints