---
title: "Registration requirements for a TLD"
method: GET
path: "/api/tlds/{tld}/metadata"
---

# Registration requirements for a TLD

`GET /api/tlds/{tld}/metadata`

## Request

- Base URL: `https://name.ai`
- URL: `https://name.ai/api/tlds/{tld}/metadata`
- Auth: none declared

Allowed registration period range, organization/nameserver requirements, and other registry policy, resolved from live registry data.

## Path parameters

- `tld` string, required

## Response `200`

TLD metadata. Deprecation/Sunset/Link headers appear only once the operation is deprecated (see x-deprecation-policy).

- object
  - `tld` string
  - `provider` string
  - `periodsMonths` integer[]: Allowed registration lengths, in months.
  - `minPeriodMonths` integer
  - `maxPeriodMonths` integer
  - `allowedYears` integer[]
  - `minYears` integer
  - `maxYears` integer
  - `organizationRequired` boolean
  - `organizationAllowed` boolean
  - `allowedCountries` string[]: Empty array means no country restriction.
  - `minNameservers` integer
  - `maxNameservers` integer
  - `nameserversRequired` boolean
  - `idnSupport` boolean
  - `premiumSupport` string
  - `transferRequiresAuthcode` boolean
  - `featuresAvailable` string[]
  - `source` 'rtr'
  - `lastSyncedAt` string, date-time
  - `stale` boolean

## Other responses

- `404`: No metadata available for this TLD.
- `429`: Per-IP limit exceeded (120 requests/minute).

---

[API](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1.md) · [All operations](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1/llms.txt) · [OpenAPI document](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1/revisions/e04300069786?raw)