# Get name registry

`GET https://api.unique.domains/v1/names/{name}/registry`

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.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON
- API: Domain Check API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `name` | string | Required | Path | 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`. |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

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

## Response

| Field | Type | Description |
| --- | --- | --- |
| `read` | boolean |  |
| `observedOn` | string \| null |  |
| `observedAt` | string \| null | Keyed. |
| `createdAt` | string \| null |  |
| `updatedAt` | string \| null |  |
| `expiresAt` | string \| null |  |
| `registryUpdatedAt` | string \| null |  |
| `registrar` | object \| null |  |
| `eppStatuses` | object[] |  |
| `nameservers` | string[] |  |
| `dnssec` | boolean \| null |  |
| `holder` | object |  |
| `transport` | string \| null |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`validation_failed`](https://unique.domains/api/problems/validation_failed) | 400 | A value is not valid |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |

## 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
  }
}
```

API status: https://uniquedomains.instatus.com

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