Case Study - Defending against DDoS attacks, improving DNS management, and enhancing web redirects

Get available contact countries

Description

Get available contact countries for a specific domain and contact type.


Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Name of the domain
contact-type String Required The contact type you want to check. You can see the available contact types for the domain from here

Return: Array with the country codes with the country names


Errors

When the authenctication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

In case the credentials of API sub user are invalid, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect sub-auth-id, sub-auth-user or auth-password."}

In case the domain is misspelled wrong or it is missing, the following status and statusDescription will be returned:

{ "status": "Failed", "statusDescription": "Missing domain-name" }

In case the the registrant type is not correct, the following status and statusDescription will be returned:

{ "status": "Failed", "statusDescription": "Invalid contact-type for this domain name." }

Note: These are example errors in JSON format, if there are missing or wrong parameters, an error will be displayed again.



Example

URL JSON: https://api.cloudns.net/domains/get-contacts-available-countries.json
POST/GET: auth-id=0&auth-password=password&domain-name=example.com&contact-type=registrant
POST/GET: sub-auth-id=0&auth-password=password&domain-name=example.com&contact-type=registrant

URL XML: https://api.cloudns.net/domains/get-contacts-available-countries.xml
POST/GET: auth-id=0&auth-password=password&domain-name=example.com&contact-type=registrant
POST/GET: sub-auth-id=0&auth-password=password&domain-name=example.com&contact-type=registrant

 


Last modified: 2023-08-29
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more