API Actions

RegisterDomain:

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

Request Parameters
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to 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 First part of user address
address2 String No Second part of 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 First part of admin user address
adminaddress2 String No Second part of 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://my.host.al/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
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to 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 First part of user address
address2 String No Second part of 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 First part of admin user address
adminaddress2 String No Second part of 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://my.host.al/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
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to domain name
regperiod Number Yes Registration period
Example Request:
curl 'https://www.host.al/clientarea/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
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to domain name
Example Request:
curl 'https://www.host.al/clientarea/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
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to 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://www.host.al/clientarea/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"}

GetContactDetails

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

Request Parameters
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to domain name
Example Request:
curl 'https://www.host.al/clientarea/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
NameTypeRequired?Description
sld String Yes Domain name
tld String Yes Suffix attached to domain name
contactdetails Array Yes  
Example Request:
curl 'https://www.host.al/clientarea/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"}}

Was this answer helpful?

 Print this Article

Also Read

API Introduction

API Introduction The Domains Reseller API allows you to interact with our system programmatically...

Example Code (PHP)

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

Install the Host.al Domain Reseller Registrar module in WHMCS

Below you can find instructions for installation of the registrar module on reseller WHMCS.Make...