# 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

```bash
curl -X GET "https://api.unique.domains/v1/names/get.plumbing/registry"
```

## Example answer

200, application/json

```json
{
  "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

- [GET /names/{name}/registry](https://unique.domains/api/get-name-registry) (Free): The registry record of one name: dates, registrar, status codes, nameservers, DNSSEC and holder.
- [GET /names/{name}/registry/history](https://unique.domains/api/get-name-registry-history) (Paid): The past versions of one name's registry record and what moved between them.

## Ways to call it

- On RapidAPI: WHOIS Lookup API, https://rapidapi.com/dopamyn-network-dopamyn-network-default/api/whois-lookup24
- From Node.js: `npm install @uniquedomains/whois`, or `npx @uniquedomains/whois get.plumbing`
- From any language: https://unique.domains/api

## Questions

### Is this WHOIS API free?

The registry 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 WHOIS 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 registry answers over WHOIS, over RDAP or both, and the record has the same fields either way: registrar, dates, status codes, name servers, DNSSEC and holder. Its transport field names the format.

Full reference: https://unique.domains/api
