11 Domain API: Start gTLD email verification

This is a series of articles in which we are going to cover registrant contact verification.

This is a second article in a series in which we are going to start email verification procedure for a gTLD domain owner. Navigate here to go back to a previous article. To get more information about our API in general, please use our documentation portal as your reference.

Due to ICANN requirements, Openprovider is obliged to verify the validity of each email address that is used in the owner contact details of any gTLD registration. gTLDs include all extensions that are not country codes (ccTLDs): common generics like .com, .net and .travel, and all new gTLDs like .guru, .berlin and .app.

Usually, this process is handled automatically depending on the actions that are being applied to a domain. More on this could be found in our Knowledge Base. However, if for some reason the process should be re-initiated, we have corresponding API methods for the very same purpose.

Restarting validation

One should use Start Email Verification method in order to start validation of an owner's email address.

Entering Geo Fence iconUse endpoint path below. Base URL is determined by both the target environment and API version.
GET {base_url}/customers/verifications/emails/start

REQUEST VALUES

Name Type Description
email string Required.

REQUEST EXAMPLE

curl -X POST \
https://api.openprovider.eu/v1beta/customers/verifications/emails/start \
-H 'Authorization: ' \
-H 'Content-Type: application/json' \
-d '{
"email": "email@domain.com",
"handle": "XX123456-XX",
"language": "en"
}'

RESPONSE EXAMPLE

{
"code": 20001,
"data": {
"id": 15466
},
"desc": "Verification email in progress"
}

RESPONSE VALUES

Name Type Description
id integer  

Now that the verification email has been sent to a domain owner, he or she needs to follow its instructions in order to prevent domain suspension.

If, for any reason, you have to reinitiate this procedure, please consider utilising Restart Email Verification method.

Was this article helpful?
Additional questions? Submit a request