---
title: "Get TLD price data"
method: GET
path: "/v1/registrar/tlds/{tld}/price"
tags: ["domains-registrar"]
---

# Get TLD price data

`GET /v1/registrar/tlds/{tld}/price`

Get price data for a specific TLD. This only reflects base prices for the given TLD. Premium domains may have different prices. Use the [Get price data for a domain](https://vercel.com/docs/rest-api/reference/endpoints/domains-registrar/get-price-data-for-a-domain) endpoint to get the price data for a specific domain.

## Path parameters

- `tld` string, required — A valid TLD name

## Query parameters

- `years` string — The number of years to get the price for. If not provided, the minimum number of years for the TLD will be used.
- `teamId` string

## Response `200`

Success

- object
  - `years` number, required — The number of years the returned price is for.
  - `purchasePrice` union, required
    - number
    - string
  - `renewalPrice` union, required
    - number
    - string
  - `transferPrice` union, required
    - number
    - string

## Other responses

- `400` — There was something wrong with the request
- `401` — Unauthorized
- `403` — NotAuthorizedForScope
- `429` — TooManyRequests
- `500` — InternalServerError

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)