Domain Registration

Domains can be registered in Real-Time with the API AddDomain command.

command = AddDomain
domain  = (DOMAIN)

REQUIRED

ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)

X-PT-REGISTRANT-VATID = <VATNUMBER>
X-PT-ADMIN-VATID = <VATNUMBER>
X-PT-TECH-VATID = <VATNUMBER>

OPTIONAL

auth = <TEXT> | <NULL>
transferlock = 0 | 1 | <NULL>
subuser = <TEXT> | <NULL>

X-IDN-LANGUAGE = <TEXT>

Domain Transfer

The transfer has to be initiated by the gaining registrar and can be requested with the API TransferDomain command. The authcode must be obtained at the registries website by the domain-owner.

command = TransferDomain
domain = (DOMAIN)

REQUIRED

action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER
auth = <TEXT>

OPTIONAL

order = CREATE | REPLACE | UPDATE

subuser = <TEXT> | <NULL>
period = <PERIOD>
transferlock = 0 | 1 | <NULL>

Delete Domain

Domains can be deleted with the API DeleteDomain command.
There is a Deletion Restorable Period of 30 days.

command = DeleteDomain
domain = (DOMAIN)

Restore Domain

Restores can be processed in realtime. A restore is possible within 30 days upon deletion. Please use the command RestoreDomain.

command = RestoreDomain
domain = (DOMAIN)

OPTIONAL

renewalmode = <NULL> | <TEXT>
subuser = <TEXT>

Ownerchange

An Ownerchange is free of charge and can be done with the API ModifyDomain command.

REQUIRED

X-PT-REGISTRANT-VATID = <TEXT> (max. 255 chars)

OPTIONAL

renewalmode = <NULL> | <TEXT>
subuser = <TEXT>

Registration

You always have to provide the vat identifier of registrant, admin, and technical contact, if the respective contact is used for a .PT domain for the first time. If the registrant contact is identical to the admin contact and technical contact, you only have to provide the vat identifer for the registrant. In case that the respective contact is for a private person the ID-card/Passport number has to be specified.

X-PT-REGISTRANT-VATID = <TEXT> (max. 255 chars) Required if the contact is used for the first time for a .PT domain
X-PT-ADMIN-VATID = <TEXT> (max. 255 chars) Required if the contact is used for the first time for a .PT domain
X-PT-TECH-VATID = <TEXT> (max. 255 chars) Required if the contact is used for the first time for a .PT domain

Example command:

command=AddDomain
domain= <DOMAIN>
...
...
X-PT-REGISTRANT-VATID = <VATNUMBER>
X-PT-ADMIN-VATID = <VATNUMBER>
X-PT-TECH-VATID = <VATNUMBER>

Transfer

To transfer a domain you first have to request the so-called authorization code and also the process number of the domain online in the registries web-interface. The registries website is accessible on http://www.dns.pt, with your login and password. After the login, please be so kind and enter the process file, and use the link “transfer code”.

Please note that you also need to provide a so called "ROID" to transfer a domain name. API users should provide this value with the parameter

X-PT-ROID = <TEXT>

Deletion

Domains can be deleted with the DeleteDomain command. If you delete a .PT domain it will not be renewed but it will expire at the end of its term.

Ownerchange

You also have to state the VAT identifier of the new registrant:

X-PT-REGISTRANT-VATID = <TEXT> (max. 255 chars) Required

Restore Process

Domain Import

X-PT-ROID = <TEXT> (max. 255 chars) Required - The ROID of the domain

Example command:

command = ImportDomain
domain = <DOMAIN>
x-pt-roid = 12345

the following zones can be managed:

• PT: no restrictions on domain name
• COM.PT: no restrictions on domain name
• EDU.PT: educational purposes
• INT.PT: international organizations
• NET.PT: telecommunication providers
• NOME.PT: individuals
• ORG.PT: non-profit organizations
• PUBL.PT: publications