RRPproxy Homepage
RRPproxy Homepage


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.

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, RRPproxy 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 contactdata-validation@key-systems.net 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 RRPproxy 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.

command         = AddDomain
domain          = yourdomain.co.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 = ModifyDomain
domain  = yourdomain.co.uk

Domain Renewal

(API Command reference » RenewDomain)
command    = RenewDomain
domain     = yourdomain.co.uk
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)
command = PushDomain
domain  = yourdomain.co.uk
target  = DETAGGED

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

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain  = yourdomain.co.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 .co.uk domain is transferred successfully, the remaining registration period is kept.
  • Please do not forget to initiate the transfer in the RRPPRoxy, 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 RRPProxy, the transfer will timeout after 5 days.
  • A list of registrars and their corresponding IPS-Tag can be found on the Nominet registrar list website.


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

The TransferOUT of a .co.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)
Standard command
command = RestoreDomain
domain  = yourdomain.co.uk

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

Restore procedure for de-tagged domains

command = TransferDomain
domain  = yourdomain.co.uk
action  = request

The domain owner has to re-tag the domain at the registry. Please note that this is bound to additional costs. Further information about how to re-tag your domain can be found at Nominet's "manage your domain" website.

Domain Extensions

X-UK-OWNER-CORPORATE-NUMBERUK companies house registration 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).

Wedomains :)