Description
The ICANN Registrar Accreditation Agreement of 2013 is an agreement between ICANN - the body responsible for administrating the Domain Name System at it's highest level - and the domain registry's which sell domain names to individuals and resellers. You can find more information about the RAA at this link:
https://www.icann.org/resources/pages/approved-with-specs-2013-09-17-en
One of the implications of the RAA is that all contact information associated with a registered domain name must be accurate and up-to-date. When a domain name is registered for the first time, you have to setup and associate contact information with that domain. When this happens, the registry that handles that domain is required by the RAA to prove the validity of your contact details, and so they will attempt to contact you for verification at this point. If a domain registry does not receive a response back to their RAA Verification attempt within 15 days, they may suspend domains and services associated with the unverified contact details.
With this HTTP API method you can get the current verification status of your 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: String with the current verification status OR array with status and status description, if there is a problem to fetch current verification status.
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 if the requested domain does not exist in your account, 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/get-raa-status.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/get-raa-status.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