Domain:update

Updating a domain

The following section describes how to update the data of an existing domain. The domain:update request is similiar to the domain:create request with the exception that for a domain:update the XML request is slightly different and most of the sections are optional. You only have to specify the name of the domain and the sections you want to update.

If you want to update your nameservers, you have to specify a complete set of new nameservers. The existing nameservers will be replaced by the new ones. If you do not specify any nameservers in your request, the existing ones will remain unchanged.

You can update only one of the four contacts, if you specify a contact you must however specify all the information for this contact.

Please note that for some top-levels domains you have to perform a domain:trade to update the organisational contact. If you try to change the organisational contact of such a domain by using the domain:update command, our API server will return an error.

To find out whether you have to perform a trade or not to change the organisational contact, simply send a tld:info request to the API Server and parse the element tld:tradeRequired of the result.

.* General template
For top-level domains that require no additional information
.AC.VN Template to update .ac.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.AMSTERDAM Template to update .amsterdam domains
Legal form
.BIZ.VN Template to update .biz.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.BT Template to update .bt domains
Registrant's company number
TradeMark identification in base 64
Registrant's ID Card number
.BY Template to update .by domains
Registrant's ID Card / Personal number OR VAT / CRC number
Registrant's passport isue date
Registrant's passport issuer
Registrant's passport number
.BZ.IT Template to update .bz.it domains
Admin Province code (if italian)
Entity type
World Intellectual Property Organization
Owner Province code (if italian)
Organisation's contact registration code
Tech Province code (if italian)
.CA Template to update .ca domains
Province or state (Administrative contact)
Province of the billing
Approve the .CA domains CIRA agreement
Registrant legal type
Province of the owner
Province of the technical
Trademark Number
.CAREER Template to update .career domains
Company registration Number
Company Type
.CO.HU Template to update .co.hu domains
IDentification document in base 64
Registrant's ID Card Number
Trademark Number
.CO.ID Template to update .co.id domains
Identity identification in base 64
.CO.IT Template to update .co.it domains
Admin Province code (if italian)
Entity type
World Intellectual Property Organization
Owner Province code (if italian)
Organisation's contact registration code
Tech Province code (if italian)
.CO.OM Template to update .co.om domains
Identity identification in base 64
.CO.UK Template to update .co.uk domains
Company registration Number
Company Type
.COM.BY Template to update .com.by domains
Registrant's ID Card / Personal number OR VAT / CRC number
Registrant's passport isue date
Registrant's passport issuer
Registrant's passport number
.COM.EE Template to update .com.ee domains
Administrative contact Country Code
Administrative identity number
Administrative Identity type document
Registrant Country Code
Registrant Company number
Registrant identity type document
Technical contact Country Code
Technical company number
Technical Identity type document
.COM.ES Template to update .com.es domains
Administrative Identity number
Technical Identity number
.COM.HK Template to update .com.hk domains
Individual Identification number
Individual Identification document Country Code
Type of the document
Registrant industry type
Other individual Identification document (if OTHIDV)
Registrant is over 18 years of age (0/1)
.COM.LB Template to update .com.lb domains
TradeMark identification in base 64
.COM.OM Template to update .com.om domains
Identity identification in base 64
.COM.PT Template to update .com.pt domains
Identification (1-20 characters)
.COM.RO Template to update .com.ro domains
State/Province for registrant contact
.COM.SG Template to update .com.sg domains
Singapore Personal Access ID of administrative contact
Registrant passport number
.COM.VN Template to update .com.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.CYMRU Template to update .cymru domains
Company registration Number
Company Type
.DESI Template to update .desi domains
Company registration Number
Company Type
.DK Template to update .dk domains
Pin code
.ECO Template to update .eco domains
.EDU.ES Template to update .edu.es domains
Administrative Identity number
Technical Identity number
.EDU.VN Template to update .edu.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.EE Template to update .ee domains
Administrative contact Country Code
Administrative identity number
Administrative Identity type document
Registrant Country Code
Registrant Company number
Registrant identity type document
Technical contact Country Code
Technical company number
Technical Identity type document
.ES Template to update .es domains
Administrative Identity number
Technical Identity number
.EU Template to update .eu domains
.FI Template to update .fi domains
Administrative contact types
Registrant birthdate
Registrant register number
Is registrant contact finnish ?
Registrant contact types
Technical contact types
.GOB.ES Template to update .gob.es domains
Administrative Identity number
Technical Identity number
.HEALTH.VN Template to update .health.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.HK Template to update .hk domains
Individual Identification number
Individual Identification document Country Code
Type of the document
Registrant industry type
Other individual Identification document (if OTHIDV)
Registrant is over 18 years of age (0/1)
.HU Template to update .hu domains
IDentification document in base 64
Registrant's ID Card Number
Trademark Number
.IE Template to update .ie domains
County/state for admin contact
County/state for owner contact
County/state for tech contact
.INFO.RO Template to update .info.ro domains
State/Province for registrant contact
.INFO.VN Template to update .info.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.INT.VN Template to update .int.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.IT Template to update .it domains
Admin Province code (if italian)
Entity type
World Intellectual Property Organization
Owner Province code (if italian)
Organisation's contact registration code
Tech Province code (if italian)
.JOBS Template to update .jobs domains
Company registration Number
Company Type
.JP Template to update .jp domains
State of administrator contact
State of the billing contact
State of the owner contact
State of the technical contact
.KIWI Template to update .kiwi domains
.LT Template to update .lt domains
.LTD.UK Template to update .ltd.uk domains
Company registration Number
Company Type
.ME.UK Template to update .me.uk domains
Company registration Number
Company Type
.NAME.VN Template to update .name.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.NET.VN Template to update .net.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.NL Template to update .nl domains
Legal form
.NO Template to update .no domains
Organization number
.NOM.ES Template to update .nom.es domains
Administrative Identity number
Technical Identity number
.NU Template to update .nu domains
Registrant's passport number
.ORG.ES Template to update .org.es domains
Administrative Identity number
Technical Identity number
.ORG.HU Template to update .org.hu domains
IDentification document in base 64
Registrant's ID Card Number
Trademark Number
.ORG.PT Template to update .org.pt domains
Identification (1-20 characters)
.ORG.UK Template to update .org.uk domains
Company registration Number
Company Type
.ORG.VN Template to update .org.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.PLC.UK Template to update .plc.uk domains
Company registration Number
Company Type
.PRO.VN Template to update .pro.vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.PT Template to update .pt domains
Identification (1-20 characters)
.REALESTATE Template to update .realestate domains
Company registration Number
Company Type
.RO Template to update .ro domains
State/Province for registrant contact
.SE Template to update .se domains
Registrant's passport number
.SG Template to update .sg domains
Singapore Personal Access ID of administrative contact
Registrant passport number
.SK Template to update .sk domains
Registrant contact birthdate (YYYY-MM-DD)
Registrant register number
.SWISS Template to update .swiss domains
enterpriseID
.SX Template to update .sx domains
.TEL Template to update .tel domains
Publish (Y / N)
Whois type (Legal, Natural)
.TV.IT Template to update .tv.it domains
Admin Province code (if italian)
Entity type
World Intellectual Property Organization
Owner Province code (if italian)
Organisation's contact registration code
Tech Province code (if italian)
.UK Template to update .uk domains
Company registration Number
Company Type
.US Template to update .us domains
Purpose for organizational contact
Category of the individual contact
.VN Template to update .vn domains
Administrative contact Identification or Passport Number (between 2 and 50 characters)
Administrative contact birthdate (YYYY-MM-DD)
Administrative contact Gender
Admin Identity
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Billing Identity
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
Tech Identity
.WALES Template to update .wales domains
Company registration Number
Company Type
.WEB.ID Template to update .web.id domains
Identity identification in base 64
.XN--E1A4C Template to update .xn--e1a4c domains
.XN--J6W193G Template to update .xn--j6w193g domains
Individual Identification number
Individual Identification document Country Code
Type of the document
Registrant industry type
Other individual Identification document (if OTHIDV)
Registrant is over 18 years of age (0/1)
.XN--QXA6A Template to update .xn--qxa6a domains
.XXX Template to update .xxx domains
Membership identification
Membership choice