Get RAA status


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:

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.


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.


POST/GET: auth-id=0&auth-password=password&
POST/GET: sub-auth-id=0&auth-password=password&

POST/GET: auth-id=0&auth-password=password&
POST/GET: sub-auth-id=0&auth-password=password&

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