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)
command         = AddDomain
domain          = yourdomain.rio
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)

After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

Domain Modification

(API Command reference » ModifyDomain)

Change of registrant

command = ModifyDomain
domain  = yourdomain.rio
ownercontact0        = (CONTACT)

Although this transaction will be immediately processed if all policy requirements are met, the new registrant will be subject to verification with the tax authorities. If the taxpayer ID of the new registrant is not in good standing, the domain will be put into ServerHold status.

Domain Renewal

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

Domain Deletion

(API Command reference » DeleteDomain)
COMMAND = DeleteDomain
DOMAIN = yourdomain.rio

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain = yourdomain.rio
action = REQUEST
auth = (TEXT)

Transfer procedure

  • After the transfer has been requested, our backend system sends a confirmation email to the Owner/Admin-C according to the WHOIS of the respective domain. In order to initiate the transfer successfully it is important, that this email is confirmed.
  • After confirmation the transfer is initiated through the official registry and the losing registrar will receive the transfer request.
  • The losing registrar will also send an email to the Owner/Admin-C. allowing him/her to deny the transfer. If you do not respond to the email of the losing registrar, then the transfer will get processed successfully after 5 days.

If the Email-Address in the WHOIS is invalid, then the transfer cannot be processed.If this is the case, then kindly contact your current registrar and ask him to update the WHOIS information accordingly.

Transfer notes

  • A .rio domain transfer must be initiated with a so-called authorisation code, which can be obtained from the current registrar through the owner or Admin-C of the domain.
  • Ensure that your respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD). This can be seen in the WHOIS.
  • If the domain is locked, then the owner can demand that the domain will be unlocked.
  • Please note that we are only allowed to initiate a gTLD transfer after confirmation of the "ICANN Form of Authorization" by the current registrant. The policies can be viewed under http://www.icann.org/transfers/
  • After a successful transfer of the domain, it will be transfer locked from the registry for a period of 60 days.
  • After a successful transfer, the domain lifecycle starts from beginning (date of Transfer + 1 year).


The format for auth info requires a minimum length of 8 characters and a maximum length of 32 characters.

Additionally, auth info must contain at least one of each of the following three character types:

  • Alphabetic characters: a-z; A-Z
  • Numeric characters: 0-9
  • Special characters: !;<=$%?&@[()]*^+-,'-{.|/}:~

Domain Restore

(API Command reference » RestoreDomain)
command = RestoreDomain
domain  = yourdomain.rio

Domain Extensions

X-BR-REGISTER-NUMBERThe CPF is the financial identity number provided by the Brazilian Government for every Brazilian citizen in order to charge taxes and financial matters. The CNPJ is the same as the CPF but it works for companies.
CPF must be given in the following format: NNN.NNN.NNN-NN
CNPJ must be given in the following format: NN.NNN.NNN/NNNN-NN

Domain Restrictions

  • Names under .rio are only for usage by the city council of Rio.
  • A .rio domain owner needs to be either:
    • Legal entity incorporated in Brazil, with headquarters, branch, franchisee or licensee located in the city of Rio de Janeiro, with active record in “Cadastro Nacional das Pessoas Jurídicas – CNPJ/MF” of the Finance Ministry.
    • Individual with fixed address in the city of Rio de Janeiro, with active record in “Cadastro das Pessoas Físicas – CPF/MF” of the Finance Ministry.
  • A domain owner that loses eligibility to a .rio domain is subject to termination of DNS publication for the domain, and to domain removal, no matter of the domain expiration date.
  • Two pre-configured nameservers are required
  • No trustee service is allowed; abuse can lead to the deletion of the domain name by the registry
  • These restrictions and additional information can be found in the registration policies

Supported IDN Scripts

The following IDN scripts are supported by .rio.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.


Get more information of "IDN tables", which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.

Wedomains :)