CentralNic Reseller Homepage
CentralNic Reseller 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.pt
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)
X-PT-OWNER-IDENTIFICATION = (TEXT)(necessary for all registrations)
X-PT-TECH-IDENTIFICATION  = (TEXT)(necessary for all registrations)

Within the first five days after submitting a registration request, the registrant may receive a request for additional data validation. As of November 18, 2021, .PT registrants who need to complete data validation can do so directly via a .PT portal. Registrants who need to validate their data will be contacted via email by the registry with instructions on where and how to upload the required information for validation. During this time, the domain will be flagged "pendingCreate" in the CentralNic Reseller system. If no documentation is provided in time, the registry will revoke the registration.

Additionally, during this five-day period, the configuration of the domain's nameservers will also be checked. If the nameservers are not configured correctly, the maintainer will receive an event to check the name server configuration.

Domain Modification

(API Command reference » ModifyDomain)
Standard command
command = ModifyDomain
domain  = yourdomain.pt

Change of registrant

command         = TradeDomain
domain          = yourdomain.pt
ownercontact0   = (CONTACT)

There is a difference between an owner change (trade) and an owner update.

Trade: Necessary if the Fiscal ID changes >> Automated, see below.
Update: Fiscal ID stays the same but e.g. company name or contact person changes >> Formgenerator (no renewal or change of lifetime circle). Send form including proof to fax@rrpproxy.net (max. 10 MB .pdf)

Ownerchange is an automated process. After the request, the new owners will receive an email from the registry and they will have to accept the trade within 8 days. If trades are not accepted within 8 days, they are cancelled. If the previous owners want to cancel an initiated trade, they can only do it manually on the registry portal ( https://registo.pt.pt/ ), provided they have/create an account.

Domain Renewal

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

Domain Deletion

(API Command reference » DeleteDomain)
COMMAND = DeleteDomain
DOMAIN = yourdomain.pt
  • After the command has been processed it will go to status pending Delete.
  • Domains can also be deleted by setting the renewal mode of the domain to AUTOEXPIRE or AUTODELETE
  • Please note that a restore is not possible after explicit deletion (DeleteDomain) of the domain

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain = yourdomain.pt
action = REQUEST
auth = (TEXT)
  • A .pt domain transfer must be initiated with a so-called authorisation code, which can be obtained from the current registrant at the registry.
  • How to receive authcode for the domain
    • Login at https://registo.dns.pt with domain holder credentials. If the login details are not known please use password forgotten function.
    • click on domain details
    • choose "related entities"
    • click on "actions" -> "Transfer Domain Management"
    • the respective authcode will then be sent to the owner contact's email address.

Domain Restore

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

Please note that a restore is only possible if the domain expired (renewalmode: AUTOEXPIRE/AUTODELETE).

If the domain was deleted explicitely with a DeleteDomain, a restore is NOT possible.

Domain Extensions

X-PT-OWNER-IDENTIFICATIONFiscal ID (VAT number) of the person or company that you are trying to register without the country code
X-PT-TECH-IDENTIFICATIONFiscal ID (VAT number) of the person or company that you are inserting as tech-contact without the country code

Domain Extensions for .EDU.PT

X-PT-LEGITIMACYRegistrant legal types; Indicates the legitimacy on registering this domain.
PC Corporate Entity
PS Individual Entity
X-PT-REGISTRATION-BASISRegistrant registration basis; Indicates the registration basis for registering this domain.Registrant registration basis; Indicates the registration basis for registering this domain.
6D Coincides with name, abbreviation, or acronym of the Teaching Establishment designation
E Statement of the Education Ministry

Domain Restrictions

  • The tech-contact for the domain will be validated by the registry.
  • Name servers have to be pre-configured prior to the registration. The configuration can be checked on the registry website at https://www.dns.pt/en/tools/.
  • The domains registered in .PT may not:
    • Correspond to words or expressions contrary to law, public order or morality
    • Correspond to any top level Internet domain name in existence or in the process of being created
    • Correspond to names that would mislead or cause confusion about their ownership, namely, by coinciding with notorious or prestigious trademarks that belong to another
    • Correspond to any protocols, applications or terms of the Internet
    • Correspond to a geographical name

Registration requirements for two character domain names are covered on the registry website. These premium domains can be registered by using the FeeExtension or the X-ACCEPT-PREMIUMPRICE=1 parameter as explained in the Premium Domain Handling article.

The most current version of the following registration rules can be found on the registry website.

  • Registering domains under .PT:
    • Article 10 Legitimacy: Domain names under .pt may be registered by all individual or corporate entities.
    • Article 11 Composing the Domain Name: Unless otherwise indicated, the domain name registered directly under .pt must obey the following rules:
      • a) Have the respective characters as set out in paragraphs 1 and 2 of article 8;
      • b) In the case of geographic names, these can only be legitimately registered by the legal administrative authority. § The legal administrative authority is understood to be that which carries out the administration on a restricted geographical constituency, namely, the State over its territory, the Regional Governments over the territory of the Autonomous Regions, the local authorities regarding their respective administrative districts, the Civil Parish Councils over the places that are part of the civil parish of the respective jurisdiction within the terms provided for in the Attachment to Law No. 11-A/2013, of 28 January, which implements the administrative reorganisation of the territory of the civil parishes and local State bodies regarding the administrative area in which they carry out their responsibilities.
  • Registering domains under .GOV.PT:
    • Article 12 Legitimacy: Domain names under .gov.pt may be registered by entities which are part of the Government structure of the Portuguese Republic.
    • Article 13 Composing the Domain Name: The domain name registered under .gov.pt must coincide with the denomination of its registrant, its abbreviation or acronym, or with the name of projects or actions which it carries out or will carry out.
    • Article 14 Registrar: The registration process for a domain under .gov.pt is carried out with CEGER – Centro de Gestão da Rede Informática do Governo (Centre for the Management of the Government's IT Network), in accordance with the regulations available at www.ceger.gov.pt whilst applying, in addition, the provisions of the present Rules.
  • Registering domains under .ORG.PT:
    • Article 15 Legitimacy: Domain names under .org.pt may be registered by non-profit organisations and individuals.
    • Article 16 Composing the Domain Name: The domain name under .org.pt must coincide with the denomination of its registrant, its abbreviation or acronym, or with the name of projects or actions that it carries out or will carry out.
  • Registering domains under .EDU.PT:
    • Article 17 Legitimacy: Public teaching establishments and owners of private and co-operative teaching establishments may register domain names under .edu.pt.
    • Article 18 Composing the Domain Name: The domain name under .edu.pt must coincide with the designation allocated on the document which identifies/recognises the nature of the educational establishment, or with an abbreviation or acronym of that designation, except, in the case of the latter, if it results in an inversion or addition to it.
  • Registering domains under .COM.PT:
    • Article 19 Legitimacy: Domain names under .com.pt may be registered by all individual and corporate entities.
    • Article 20 Composing the Domain Name: The domain name under .com.pt only has to observe the rules regarding the general conditions for composing domain names set out in articles 8 and 9.
    • Article 21 Registrations Based on Criteria Established by Law: Apart from the possibilities of registering domain names listed in the previous articles, registrations which obey conditions that are expressly described by law are also allowed.

IDN Information

Registering a domain with special characters does not imply any changes to the way the registration is carried out. For the time being, only the following special characters in the Portuguese alphabet have been considered: (`) grave accent, (´) acute accent, (^) circumflex accent and (~) tilde. These characters only make sense when applied to the Portuguese language (à; á; â; ã; ç; é; ê; í; ó; ô; õ; ú).

We domains