.uk

API commandsExtensionsRestrictions

API Commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Data Quality Policy
(further details can be found in the Nominet policies)
When registering a second- or third-level .uk domain name, please make sure that the contact handles used include the following information:

• Registrant name/organization, value has to contain a minimum of 4 characters with at least 3 letters
• street value must contain non numerical characters
• city, country and zip code must be given to be validated
• phone number has to be in the following form +Countrycode.Area code.Subscriber number
• email address has to meet the following requirements:
  • must contain an @ character
  • at least one character in front of the @ character
  • must end with a valid TLD
  • no space/blank at the beginning or end

All contact information will be checked for completeness and contact information (Name, Organization, Address) will be validated

• in a first step by Nominet
• if Nominet cannot validate the information, it has to be validated by the reseller, Centralnic Reseller will send a corresponding notification.
• The registrant is asked by the reseller to provide appropriate proof of identity, e.g. driving licence, passport, national ID card (for non-UK citizens), national insurance card (for UK citizens), official company letterhead, company stamp
• The reseller will review the documents provided by the registrant
• If the documents are correct, the reseller will forward them to [email protected] with the following syntax of the subject: [domainname.uk: Confirming validation and document accuracy] and including attached documentation, not be larger than 5MB; allowed file types: .pdf, .jpg, .jpeg. The sender and file names will only be accepted by our automated system while using US-ASCII characters.
• The email will be processed by Centralnic Reseller and the contact will be validated automatically

If no valid evidence has been provided within 29 days the domain will be suspended. However, the domain will not be deleted. Thus, validation may be processed even after the 29 days to reactivate the domain name.

Exception

command         = AddDomain
domain          = yourdomain.uk
period          = 1-10
auth            = (authcode)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0     = (NAMESERVER)
nameserver1     = (NAMESERVER)
X-UK-OWNER-CORPORATE-NUMBER = UK companies house registration number
X-UK-OWNER-CORPORATE-TYPE   = LTD | PLC | LLP | IP (type of company)

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.uk

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.uk
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Exception

command = PushDomain
domain  = yourdomain.uk
target  = DETAGGED

A .uk domain name can only be cancelled by the owner of the domain through Nominet.

Domain Transfer

(API Command reference » TransferDomain)

Exception

command = TransferDomain
domain  = yourdomain.uk
action  = request

The domain owner must contact the current registrar of the domain and ask him to change the IPS-Tag of the domain to “KEY-SYSTEMS-DE”. Once the IPS-Tag has been changed the domain will be put on your account.

Transfer notes

• Please note that when a .uk domain is transferred successfully, the remaining registration period is kept.
• Please do not forget to initiate the transfer in the Centralnic Reseller, even though your current provider only has to change the REGISTRAR-TAG or the domain will not be put on your account.
• If the tag is not changed to KEY-SYSTEMS-DE for a domain requested in the Centralnic Reseller, the transfer will timeout after 15 days.
• A list of registrars and their corresponding IPS-Tag can be found on the Nominet registrar list website.

TransferOUT

Exception

command = PushDomain
domain  = yourdomain.uk
target  = IPS-TAG of gaining registrar

The TransferOUT of a .uk domain is equal to the deletion process except for the target, which has to be the IPS-Tag of the gaining registrar. It is also possible to use the TransferDomain command but the action has to be “PushDomain” and not “approve”.

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.uk

If a domain autoexpired or was autodeleted, the domain can be restored.

Domain Extensions

X-UK-OWNER-CORPORATE-NUMBER

UK companies house registration number

X-UK-OWNER-CORPORATE-TYPE

type of company OTHER - UK Entity that does not fit into any of the above FOTHER - Non-UK Entity that does not fit into any of the above IND - UK Individual (representing self) FIND - Non-UK Individual FCORP - Non-UK Corporation LTD - UK Limited Company PLC - UK Public Limited Company LLP - UK Limited Liability Partnership IP - UK Industrial/Provident Registered Company CRC - UK Corporation by Royal Charter => no CORPORATE-NUMBER GOV - UK Government Body => no CORPORATE-NUMBER PTNR - UK Partnership => no CORPORATE NUMBER RCHAR - UK Registered Charity SCH - UK School STAT UK Statutory Body => no CORPORATE NUMBER STRA UK Sole Trader => no CORPORATE NUMBER

Domain Restrictions

Nominet has been introducing registrant name restrictions on registrations and domain name transfers. The registrant name must consist of at least 7 characters and meet the following requirements:

• The registrant name must contain 4 or more characters (any), or
• The registrant name must contain 3 or more letters (a-z).