Domain info

Description

Lists the information about the domain name


 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

Return: Array with information about the registration and expiration dates, privacy protection, minimum and maximum amount of name servers allowed for this TLD, available registration/renewal periods, domain status, DNSSEC, etc.

If DNSSEC is supported, an array with the supported records for DNSSEC will be returned (DS and/or DNSKEY).

If DNSSEC is not supported, an empty array will be returned for that section.

Possible domain statuses and their meaning:

  • 0 - Expired
  • 1 - Active
  • 2 - Transfer
  • 3 - Transfer Failed

Errors

When the authentication 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."}

If there is not added a domain name or the domain name is invalid, the following status will be returned:

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

Note: These are example errors in JSON format.


Example

URL JSON: https://api.cloudns.net/domains/domain-info.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.com

URL XML: https://api.cloudns.net/domains/domain-info.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.com


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