.com.es

Registration terms: 1–5, 10 years. Transfers in are supported with an authorisation code. 12 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–5, 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	12 — 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	Not available — send full details
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	10	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-ES-ADMIN-TIPO-IDENTIFICACION	optional	DropdownList	Admin Identification Type	3, 1, 0
X-ES-BILLING-TIPO-IDENTIFICACION	optional	DropdownList	Billing Identification Type	1, 3, 0
X-ES-TECH-TIPO-IDENTIFICACION	optional	DropdownList	Tech Identification Type	1, 3, 0
X-ES-TECH-IDENTIFICACION	optional	Text	Tech Identification Number	Free text
X-ES-OWNER-TIPO-IDENTIFICACION	optional	DropdownList	Owner Identification Type	3, 0, 1
X-ES-ADMIN-IDENTIFICACION	optional	Text	Admin Identification Number	Free text
X-ES-BILLING-LEGALFORM	optional	Text	Billing Legal Form	Free text
X-ES-ADMIN-LEGALFORM	optional	Text	Admin Legal Form	Free text
X-ES-BILLING-IDENTIFICACION	optional	Text	Billing Identification Number	Free text
X-ES-TECH-LEGALFORM	optional	Text	Tech Legal Form	Free text
X-ES-OWNER-IDENTIFICACION	optional	Text	Owner Identification Number	Free text
X-ES-OWNER-LEGALFORM	optional	DropdownList	Owner Legal Form	525, 286, 152, 554, 562, 747, 560, 269, 47, 181, 746, 877, 878, 203, 164, 59, 476, 439, 434, 68, 510, 612, 150, 1, 229, 744, 608, 879, 436, 124, 713, 365, 197, 717, 566, 39, 524, 745

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.com.es",
  "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-ES-ADMIN-TIPO-IDENTIFICACION": "3",
    "X-ES-BILLING-TIPO-IDENTIFICACION": "1",
    "X-ES-TECH-TIPO-IDENTIFICACION": "1",
    "X-ES-TECH-IDENTIFICACION": "<Tech Identification Number>",
    "X-ES-OWNER-TIPO-IDENTIFICACION": "3",
    "X-ES-ADMIN-IDENTIFICACION": "<Admin Identification Number>",
    "X-ES-BILLING-LEGALFORM": "<Billing Legal Form>",
    "X-ES-ADMIN-LEGALFORM": "<Admin Legal Form>",
    "X-ES-BILLING-IDENTIFICACION": "<Billing Identification Number>",
    "X-ES-TECH-LEGALFORM": "<Tech Legal Form>",
    "X-ES-OWNER-IDENTIFICACION": "<Owner Identification Number>",
    "X-ES-OWNER-LEGALFORM": "525"
  }
}

Renew

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

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

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