Registration terms: 1–10 years. Transfers in are supported with an authorisation code. 15 extra registry fields (0 required).
- This extension has extra registry fields — see Extra fields below. Which ones you must send can depend on the value of another field.
At a glance
Section titled “At a glance”| Property | Value |
|---|---|
| Registration terms | 1–10 years |
| Renewal terms | 1–10 years |
| Transfer in | Supported · authorisation code required · pre-transfer check not available |
| Transfer lock | Can be turned on and off |
| Extra registry fields | 15 — see below |
| Registry documents | Not required |
| Trustee service | Not available |
| WHOIS privacy | Available |
| DNSSEC | Supported |
| IDN (non-ASCII names) | Supported |
| Name servers under the domain | Not allowed |
| Contact change by handle | Available |
| Registry checks name servers | No |
| Test environment | Available |
What each property means and which error you get if you ignore it: TLD catalogue.
Lifecycle
Section titled “Lifecycle”In calendar days. — means the registry does not publish the period.
| Period | Days | What happens |
|---|---|---|
| Add grace | — | Deleting a new registration within this window is refunded. |
| Auto-renew grace | 20 | After expiry the registry renews automatically; a second renewal in this window is refused with 10020. |
| Redemption | 30 | After deletion, POST /api/v1/domains/restore still works. |
| Deletion hold | — | After redemption, before the name is released to the public. Nothing can be done. |
Extra fields (tldAttributes)
Section titled “Extra fields (tldAttributes)”Send these as a flat key/value object named tldAttributes on register requests. See Extra registry fields.
| Key | Required | Type | Description | Allowed values |
|---|---|---|---|---|
X-FR-BIRTHPLACE |
optional | Text | Birthplace country code | Free text |
X-FR-BIRTHDATE |
optional | Text | Birthdate | Free text |
X-FR-RESTRICT-PUB |
optional | DropdownList | Restrict Whois Publication | 0, 1 |
X-FR-LOCAL |
optional | Text | Company Local Identifier | Free text |
X-FR-VATID |
optional | Text | Company VAT ID | Free text |
X-FR-WALDEC |
optional | Text | Waldec ID | Free text |
X-FR-BIRTHCITY |
optional | Text | Birth City | Free text |
X-FR-SIREN-OR-SIRET |
optional | Text | SIREN or SIRET Number | Free text |
X-FR-BIRTHPC |
optional | Text | Birth Postcode | Free text |
X-FR-DUNS |
optional | Text | Company DUNS Number | Free text |
X-FR-TRADEMARK |
optional | Text | Trademark Number | Free text |
X-FR-NUMERO-DE-PAGE-ANNOUNCE-JO |
optional | Text | Official Gazette Page Number | Free text |
X-FR-ANNOUNCE |
optional | Text | Announcement Number | Free text |
X-FR-DATE-ASSOCIATION |
optional | Text | Association Date | Free text |
X-FR-DATE-PUBLICATION-JO |
optional | Text | Official Gazette Publication Date | Free text |
Ready-to-send requests
Section titled “Ready-to-send requests”Each request below is built from this extension’s catalogue entry. Replace the domain, the handles and any value in <angle brackets>.
Register
Section titled “Register”POST /api/v1/domains/register with contact handles you created with POST /api/v1/contacts. To send contact details inline instead, use POST /api/v1/domains/register-with-contacts with the same tldAttributes.
tldAttributes lists every field this extension defines. Send the ones that apply: the table above says which are required, and some become required only for a particular value of another field.
{ "domainName": "apiname.yt", "period": 1, "nameServers": [ "tr.apiname.com", "eu.apiname.com" ], "handles": [ { "contactType": "Registrant", "handle": "D-174829301847" }, { "contactType": "Admin", "handle": "D-174829301847" }, { "contactType": "Tech", "handle": "D-174829301847" }, { "contactType": "Billing", "handle": "D-174829301847" } ], "tldAttributes": { "X-FR-BIRTHPLACE": "<Birthplace country code>", "X-FR-BIRTHDATE": "<Birthdate>", "X-FR-RESTRICT-PUB": "0", "X-FR-LOCAL": "<Company Local Identifier>", "X-FR-VATID": "<Company VAT ID>", "X-FR-WALDEC": "<Waldec ID>", "X-FR-BIRTHCITY": "<Birth City>", "X-FR-SIREN-OR-SIRET": "<SIREN or SIRET Number>", "X-FR-BIRTHPC": "<Birth Postcode>", "X-FR-DUNS": "<Company DUNS Number>", "X-FR-TRADEMARK": "<Trademark Number>", "X-FR-NUMERO-DE-PAGE-ANNOUNCE-JO": "<Official Gazette Page Number>", "X-FR-ANNOUNCE": "<Announcement Number>", "X-FR-DATE-ASSOCIATION": "<Association Date>", "X-FR-DATE-PUBLICATION-JO": "<Official Gazette Publication Date>" }}POST /api/v1/domains/renew — call POST /api/v1/domains/renew/check with the same body first. See Renew a domain.
{ "domainName": "apiname.yt", "period": 1}Transfer in
Section titled “Transfer in”POST /api/v1/domains/transfer. This registry has no pre-transfer check, so call it directly. See Transfer a domain in.
{ "domainName": "apiname.yt", "authCode": "aB3!xY9-kL2pQ7", "period": 1}From the TLD catalogue on 2026-11-02. For live values call GET /api/v1/products/tlds?filterText=yt.