# List TLD prices

`GET https://api.unique.domains/v1/prices/tlds/{tld}`

Every registrar's list price for one ending, with the cheapest and trap marks.

Registrar catalog order, then other registrars alphabetically. Free on a public-set ending; outside it the free tier reads one ending a UTC day.

- 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 |
| --- | --- | --- | --- | --- |
| `tld` | string | Required | Path | The ending without the dot (`ai`); lowercased, a leading dot stripped. |
| `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/prices/tlds/io"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `registrar` | string |  |
| `name` | string |  |
| `homepageUrl` | string |  |
| `purchasePrice` | number |  |
| `renewalPrice` | number |  |
| `transferPrice` | number |  |
| `currency` | string |  |
| `isPromo` | boolean | First year is a promotion. |
| `regularPurchasePrice` | number |  |
| `renewalTrap` | boolean | Renewal at least twice the first year and $10 more. |
| `cheapest` | boolean | Lowest first year. |
| `cheapestRenewal` | boolean | Lowest renewal. |
| `cheapestTransfer` | boolean | Lowest transfer-in. |

## 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": [
    {
      "registrar": "cloudflare",
      "name": "Cloudflare",
      "homepageUrl": "https://www.cloudflare.com/products/registrar/",
      "purchasePrice": 38.5,
      "renewalPrice": 38.5,
      "transferPrice": 38.5,
      "currency": "USD",
      "isPromo": false,
      "renewalTrap": false,
      "cheapest": true,
      "cheapestRenewal": true,
      "cheapestTransfer": true
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/prices/tlds/io",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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