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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
.CA Template to update .ca domains
Province of the administrator
Province of the billing
Approve the .CA domains CIRA agreement
Registrant legal type
Province of the owner
Province of the technical
Trademark Number
.CO.HU Template to update .co.hu domains
IDentification document in base 64
Registrant's ID Card 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)
Use trustee contact (yes/no)
.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
Document Type (HKID=>HongKong ID; OTHID=>Other Country ID;PASSNO=>Passport;BIRTHCERT=> Birth Certificate;OTHIDV=>Other doc)
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
Identity identification in base 64
.COM.PT Template to update .com.pt domains
Identification (1-20 characters)
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.CYMRU Template to update .cymru domains
Company registration Number
Company Type
.DK Template to update .dk domains
Pin code
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.HK Template to update .hk domains
Individual Identification number
Individual Identification document Country Code
Document Type (HKID=>HongKong ID; OTHID=>Other Country ID;PASSNO=>Passport;BIRTHCERT=> Birth Certificate;OTHIDV=>Other doc)
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
.IE Template to update .ie domains
County for administrative contact in GB
Registrant Company Number
nationality
Technical residence county
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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)
Use trustee contact (yes/no)
.JOBS Template to update .jobs domains
Industry type
Is association member
Title
Website
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
.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
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.PT Template to update .pt domains
Identification (1-20 characters)
.SE Template to update .se domains
Registrant's company 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
Whois type (Legal, Natural)
.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
Billing contact Identification or Passport Number (between 2 and 50 characters)
Billing birthdate
Billing gender
Registrant contact Identification or Passport Number (between 2 and 50 characters)
Registrant contact birthdate (YYYY-MM-DD)
Registrant contact Gender
Company name
Company type (INC, LTD, SARL, GMBH ....)
Technical contact Identification or Passport Number (between 2 and 50 characters)
Technical contact birthdate (YYYY-MM-DD)
Technical contact Gender
.WALES Template to update .wales domains
Company registration Number
Company Type
.WEB.ID Template to update .web.id domains
Identity identification in base 64
.XXX Template to update .xxx domains
Membership identification
Membership choice