.tf

View as Markdown Open in Claude Open in ChatGPT

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

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	Not available
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

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	—	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`)

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-DATE-PUBLICATION-JO`	optional	Text	Official Gazette Publication Date	Free text
`X-FR-BIRTHPC`	optional	Text	Birth Postcode	Free text
`X-FR-WALDEC`	optional	Text	Waldec ID	Free text
`X-FR-TRADEMARK`	optional	Text	Trademark Number	Free text
`X-FR-BIRTHCITY`	optional	Text	Birth City	Free text
`X-FR-BIRTHDATE`	optional	Text	Birthdate	Free text
`X-FR-LOCAL`	optional	Text	Company Local Identifier	Free text
`X-FR-DATE-ASSOCIATION`	optional	Text	Association Date	Free text
`X-FR-NUMERO-DE-PAGE-ANNOUNCE-JO`	optional	Text	Official Gazette Page Number	Free text
`X-FR-BIRTHPLACE`	optional	Text	Birthplace country code	Free text
`X-FR-SIREN-OR-SIRET`	optional	Text	SIREN or SIRET Number	Free text
`X-FR-VATID`	optional	Text	Company VAT ID	Free text
`X-FR-ANNOUNCE`	optional	Text	Announcement Number	Free text
`X-FR-RESTRICT-PUB`	optional	DropdownList	Restrict Whois Publication	`1`, `0`
`X-FR-DUNS`	optional	Text	Company DUNS Number	Free text

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

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.tf",
  "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-DATE-PUBLICATION-JO": "<Official Gazette Publication Date>",
    "X-FR-BIRTHPC": "<Birth Postcode>",
    "X-FR-WALDEC": "<Waldec ID>",
    "X-FR-TRADEMARK": "<Trademark Number>",
    "X-FR-BIRTHCITY": "<Birth City>",
    "X-FR-BIRTHDATE": "<Birthdate>",
    "X-FR-LOCAL": "<Company Local Identifier>",
    "X-FR-DATE-ASSOCIATION": "<Association Date>",
    "X-FR-NUMERO-DE-PAGE-ANNOUNCE-JO": "<Official Gazette Page Number>",
    "X-FR-BIRTHPLACE": "<Birthplace country code>",
    "X-FR-SIREN-OR-SIRET": "<SIREN or SIRET Number>",
    "X-FR-VATID": "<Company VAT ID>",
    "X-FR-ANNOUNCE": "<Announcement Number>",
    "X-FR-RESTRICT-PUB": "1",
    "X-FR-DUNS": "<Company DUNS Number>"
  }
}

Renew

POST /api/v1/domains/renew — call POST /api/v1/domains/renew/check with the same body first. See Renew a domain.

{
  "domainName": "apiname.tf",
  "period": 1
}

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.tf",
  "authCode": "aB3!xY9-kL2pQ7",
  "period": 1
}

From the TLD catalogue on 2026-11-02. For live values call GET /api/v1/products/tlds?filterText=tf.

.tf