RegisterDomain:

This command is used to send a Register command to the registrar.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
regperiod Number Yes Registration period
nameserver1 String No First nameserver
nameserver2 String No Second nameserver
nameserver3 String No Third nameserver
nameserver4 String No Fourth nameserver
nameserver5 String No Fifth nameserver
dnsmanagement Number No Enables DNS management for this domain
emailforwarding Number No Enables email forwarding for this domain
idprotection Number No Enables id protection for this domain
firstname String Yes First name of the user
lastname String Yes Last name of the user
address1 String Yes The first part of the user address
address2 String No The second part of the user address
city String Yes City of the user
state String Yes State/Province of the user
postcode String Yes Postal/ZIP Code of the user
country String Yes Country of the user
phonenumber String Yes Phone number in the format +NNN.NNNNNNNNNN
email String Yes Email address of the user
adminfirstname String No First name of the admin user
adminlastname String No Last name of the admin user
adminaddress1 String No The first part of the admin user address
adminaddress2 String No The second part of the admin user address
admincity String No City of the admin user
adminstate String No State/Province of the admin user
adminpostcode String No Postal/ZIP Code of the admin user
admincountry String No Country of the admin user
adminphonenumber String No Phone number in the format +NNN.NNNNNNNNNN
adminemail String No Email address of the admin user
domainfields String No A base64 encoded serialized array of the TLD-specific field values

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=RegisterDomain&sld=exampledomain&tld=com&regperiod=1&nameserver1=ns1.yourdomain.com&nameserver2=ns2.yourdomain.com&firstname=test&lastname=test&companyname=company&address1=addresss&city=city&state=region&country=US&postcode=12345&phonenumber=1234567890&email=admin@exampledomain.com' --compressed

Example Response:

{"result":"success","msg":"Domain has been registered"}

 

TransferDomain

This command is used to send a Transfer command to the registrar.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
transfersecret String No Domain authorization code
regperiod Number Yes Registration period
nameserver1 String No First nameserver
nameserver2 String No Second nameserver
nameserver3 String No Third nameserver
nameserver4 String No Fourth nameserver
nameserver5 String No Fifth nameserver
dnsmanagement Number No Enables DNS management for this domain
emailforwarding Number No Enables email forwarding for this domain
idprotection Number No Enables id protection for this domain
firstname String Yes First name of the user
lastname String Yes Last name of the user
address1 String Yes The first part of the user address
address2 String No The second part of the user address
city String Yes City of the user
state String Yes State/Province of the user
postcode String Yes Postal/ZIP Code of the user
country String Yes Country of the user
phonenumber String Yes Phone number in the format +NNN.NNNNNNNNNN
email String Yes Email address of the user
adminfirstname String No First name of the admin user
adminlastname String No Last name of the admin user
adminaddress1 String No The first part of the admin user address
adminaddress2 String No The second part of the admin user address
admincity String No City of the admin user
adminstate String No State/Province of the admin user
adminpostcode String No Postal/ZIP Code of the admin user
admincountry String No Country of the admin user
adminphonenumber String No Phone number in the format +NNN.NNNNNNNNNN
adminemail String No Email address of the admin user
domainfields String No A base64 encoded serialized array of the TLD specific field values

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=TransferDomain&sld=exampledomain&tld=com&transfersecret=gd23h231s21&regperiod=1&nameserver1=ns1.yourdomain.com&nameserver2=ns2.yourdomain.com&firstname=test&lastname=test&companyname=company&address1=addresss&city=city&state=region&country=US&postcode=12345&phonenumber=1234567890&email=admin@exampledomain.com' --compressed

Example Response:

{"result":"success","msg":"Domain transfer initiated successfully."}

 

RenewDomain

This command is used to send a Renew command to the registrar.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
regperiod Number Yes Registration period

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=RenewDomain&sld=exampledomain&tld=com&regperiod=1' --compressed

Example Response:

{"result":"success","msg":"The domain has been successfully."}

 

GetNameservers

This command is used to obtain the nameservers of a domain.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=GetNameservers&sld=exampledomain&tld=com' --compressed

Example Response:

{"result":"success","ns1":"ns1.exampledomain.com","ns2":"ns2.exampledomain.com"}

 

SaveNameservers

This command is used to update the nameservers of a domain.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
nameserver1 String No First nameserver
nameserver2 String No Second nameserver
nameserver3 String No Third nameserver
nameserver4 String No Fourth nameserver
nameserver5 String No Fifth nameserver

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=SaveNameservers&sld=exampledomain&tld=com&ns1=ns1.exampledomain.com&ns2=ns2.exampledomain.com' --compressed

Example Response:

{"result":"success"}

 

ReleaseDomain

This command is used to send a Release command to the registrar.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
newtag String Yes The new tag for the domain

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=ReleaseDomain&sld=exampledomain&tld=com&newtag=1AND1-TEST' --compressed

Example Response:

{"result":"success"}

 

RequestDelete

This function is called when a domain is requested to be deleted

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=RequestDelete&sld=exampledomain&tld=com' --compressed

Example Response:

{"result":"success"}

 

 

 

GetContactDetails

This command is used to perform a whois lookup on a specified domain.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=GetContactDetails&sld=exampledomain&tld=com' --compressed

Example Response:

{"result":"success","Registrant":{"Name":"John Doe","Company":"Company name","Address":"P.O.","City":"Amsterdam","Country":"NL","Zip_Code":"1001 GT","Email":"john@exampledomain.com","Telephone":"N\/A"}}

 

SaveContactDetails

his command is used to update the contact information on a domain.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
contactdetails Array Yes  

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=SaveContactDetails&sld=exampledomain&tld=com&contactdetails[Registrant][Name]=John%20Doe&contactdetails[Registrant][Company]=Company%20name&contactdetails[Registrant][Address]=Address&contactdetails[Registrant][City]=Amsterdam&contactdetails[Registrant][Country]=NL&contactdetails[Registrant][Zip_Code]=1001 GT&contactdetails[Registrant][Email]=test@exampledomain.com&contactdetails[Registrant][Telephone]=N/A' --compressed

Example Response:

{"result":"success","Registrant":{"Name":"John Doe","Company":"Company name","Address":"P.O.","City":"Amsterdam","Country":"NL","Zip_Code":"1001 GT","Email":"john@exampledomain.com","Telephone":"N\/A"}}

 

DomainGetLockingStatus

This command is used to obtain the lock state of a domain.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=domaingetlockingstatus&sld=exampledomain&tld=com' --compressed

Example Response:

{"result":"success","lockstatus":"unlocked"}

 

DomainUpdateLockingStatus

This command is used to update the lock state of a domain.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
lockstatus Null/Number No To lock the domain, set it to '1'

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=domainupdatelockingstatus&sld=exampledomain&tld=com&lockstatus=' --compressed

Example Response:

{"result":"success"}

 

GetDNS
(not yet active)

This function is called when the DNS Host Records are requested to be viewed 

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=GetDNS&sld=exampledomain&tld=com' --compressed

Example Response:

{"0":{"hostname":"*","type":"A","address":"0.0.0.0","priority":null},"1":{"hostname":"mail","type":"MXE","address":"0.0.0.0","priority":"10"},"result":"success"}

 

SaveDNS
(not yet active)

This function is called when any changes to DNS Host Records information is submitted

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
dnsrecords String Yes A base64 encoded serialized array of the DNS records.
base64_encode(serialize(array(0=>array("hostname"=>"*","type"=>"A","address"=>"0.0.0.0","priority"=>"N/A","recid"=>""))));;

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=SaveDNS&sld=exampledomain&tld=com&dnsrecords=czowOiIiOw==' --compressed

Example Response:

{"result":"success"}

 

RegisterNameserver

This function is called when a child nameserver is requested to be registered Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
nameserver String Yes  
ipaddress String Yes  

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=RegisterNameserver&sld=exampledomain&tld=com&nameserver=test.exampledomain.com&ipaddress=1.1.1.1' --compressed

Example Response:

{"result":"success"}

 

ModifyNameserver

This function is called when a child nameserver is requested to be edited Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
nameserver   String Yes  
currentipaddress String Yes  
newipaddress String Yes  

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=ModifyNameserver&sld=exampledomain&tld=com&nameserver=test.exampledomain.com&currentipaddress=1.1.1.1&newipaddress=2.2.2.2' --compressed

Example Response:

{"result":"success"}

 

DeleteNameserver

This function is called when a child nameserver is requested to be deleted Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
nameserver String Yes  

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=DeleteNameserver&sld=exampledomain&tld=com&nameserver=test.exampledomain.com' --compressed

Example Response:

{"result":"success"}

 

 

 

Sync

This function gives, for a certain domain:

  • the expiry date (as from whois)
  • the next due date (the last valid date for payment of next renewal)
  • the domain status (active or not)

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=Sync&sld=exampledomain&tld=com' --compressed

Example Response:

{
[expirydate] => 2023-02-01
[nextduedate] => 2023-02-01
[active] => 1
[result] => success
}

 

TransferSync

This function is called for every domain in the Pending Transfer status each time your domain sync cron runs.

Request Parameters

Name Type Required? Description
sld String Yes Domain name
tld String Yes Suffix attached to the domain name
domain String Yes Full domain name
regperiod Int Yes Registration period

Example Request:

curl 'https://domainregister.international/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&authemail=test@exampledomain.com&action=TransferSync&sld=exampledomain&tld=com&domain=exampledomain.com&regperiod=1' --compressed

Example Response:

{"result":"success"}

Found this article interesting?
Subscribe to DomainRegister´s newsletter!

You can unsubscribe at any time by simply clicking the link in the footer of our emails. For information about our privacy practices, please visit our website.

We use Mailchimp as our marketing platform. By clicking below to subscribe, you acknowledge that your information will be transferred to Mailchimp for processing. Learn more about Mailchimp s privacy practices here.

  • API
  • 2 Users Found This Useful
Was this answer helpful?

Related Articles

 DomainRegister Third Generation API - Introduction

API Introduction The DomainRegister Third Generation API allows you to interact with our system...

 DomainRegister Third Generation API - Activation and Management

In order to be allowed to use DomainRegister Third Generation API, you're required: to be...

 DomainRegister Third Generation API - example of PHP code (RegisterDomain)

<?php $data = array( "action" => "RegisterDomain", "token" =>...

 DomainRegister Third Generation API - example of PHP code (TransferDomain)

<?php $data = array( "action" => "TransferDomain", "token" =>...

 DomainRegister Third Generation API - example of PHP code (CreditAmount)

<?php $data = array( "action" => "CreditAmount", "token" =>...