# List registrar changes

`GET https://api.unique.domains/v1/registrars/{registrar}/changes`

A registrar's confirmed list-price changes, newest first.

Free: its 10 newest confirmed changes, one page. Paid: the keyset feed on `(confirmedAt, id)`.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON, CSV (`.csv`)
- API: Registrar Prices API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `registrar` | string: namecheap, name.com, namesilo, porkbun, dynadot, cloudflare, spaceship, godaddy, unstoppable | Required | Path | A registrar catalog slug of the nine, exactly (`name.com`, no `name-com` alias). |
| `limit` | integer | Optional | Query | Rows a page: 20 by default, at most 20 without a key and 100 with a paid subscription; a larger value is clamped. |
| `cursor` | string | Paid | Query | The `meta.cursor` of the previous page; the last page answers `null`. |
| `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/registrars/namecheap/changes"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | `TldPriceChange.id` as a string. |
| `extension` | string | Bare ending. |
| `registrar` | string | Registrar slug. |
| `registrarName` | string | Display name. |
| `field` |  | Which price moved. |
| `oldPrice` | number | Before. |
| `newPrice` | number | After. |
| `currency` | string | ISO 4217. |
| `confirmedAt` | string | Confirmation timestamp. |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`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": [
    {
      "id": "48211",
      "extension": "io",
      "registrar": "namecheap",
      "registrarName": "Namecheap",
      "field": "renewal",
      "oldPrice": 53.98,
      "newPrice": 59.98,
      "currency": "USD",
      "confirmedAt": "2026-11-03T05:40:00.000Z"
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": 20
  },
  "links": {
    "self": "https://api.unique.domains/v1/registrars/namecheap/changes",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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