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.
GET {base_url}/customers/verifications/emails/start
REQUEST VALUES↓
Name | Type | Description |
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.