.eu

Registration terms: 1–10 years. Transfers in are supported with an authorisation code. 4 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	Can be turned on and off
Extra registry fields	4 — see below
Registry documents	Not required
Trustee service	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	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)

Send these as a flat key/value object named tldAttributes on register requests. See Extra registry fields.

Key	Required	Type	Description	Allowed values
X-EU-REGISTRANT-LANG	optional	DropdownList	Registrant Language	hr, fr, ga, pl, sv, lv, es, de, fi, ro, lt, cs, mt, bg, sk, sl, nl, et, en, pt, da, it, hu, el
X-EU-REGISTRANT-CITIZENSHIP	optional	DropdownList	Registrant Citizenship	be, it, es, lt, fi, gr, ro, at, se, de, nl, cy, hr, cz, ie, bg, pt, mt, ee, fr, lv, hu, dk, sk, pl, li, si, lu
X-EU-NATURALPERSON	optional	RadioButton	Natural Person	Free text
X-EU-ACCEPT-TRUSTEE-TAC	optional	RadioButton	Trustee Service Terms	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.eu",
  "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-EU-REGISTRANT-LANG": "hr",
    "X-EU-REGISTRANT-CITIZENSHIP": "be",
    "X-EU-NATURALPERSON": "<Natural Person>",
    "X-EU-ACCEPT-TRUSTEE-TAC": "<Trustee Service Terms>"
  }
}

Renew

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

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

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