# Get name registry history

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

The stored registry record versions of one name and what moved between them.

Versions and registrar moves oldest first, the distinct transfers the records name, and the lock removals of the last 90 days. A name the catalog never stored answers empty lists.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call.
- Plan: Investor plan. A Founder key answers 403 `plan_required`.
- 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/history" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `versions` | object[] |  |
| `moves` | object[] |  |
| `transfers` | object[] |  |
| `lockChanges` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`validation_failed`](https://unique.domains/api/problems/validation_failed) | 400 | A value is not valid |
| [`keyed_only`](https://unique.domains/api/problems/keyed_only) | 403 | A paid subscription is required |
| [`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": {
    "versions": [
      {
        "observedAt": "2025-06-02T04:10:00.000Z",
        "registrar": "Gandi SAS",
        "registered": true
      },
      {
        "observedAt": "2026-08-12T05:02:00.000Z",
        "registrar": "GoDaddy.com, LLC",
        "registered": true
      }
    ],
    "moves": [
      {
        "at": "2026-08-12T05:02:00.000Z",
        "from": "Gandi SAS",
        "to": "GoDaddy.com, LLC"
      }
    ],
    "transfers": [
      {
        "at": "2026-08-12T00:00:00.000Z",
        "from": "Gandi SAS",
        "to": "GoDaddy.com, LLC"
      }
    ],
    "lockChanges": [
      {
        "at": "2026-08-10T03:00:00.000Z",
        "kind": "lock_removed"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing/registry/history",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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