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

This is a first article in a series in which we are going to search for email addresses and their respective statuses with regard to the aforementioned validation procedure. 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.

Searching for email's status

First, let's focus on retrieving the status of a validation request. In order to do so we are going to utilise List domain email verifications method.

NB If there are multiple domains linked to one e-mail address, multiple rows are returned.

All input parameters in this method are optional. Omitting all at once will result into a full list of email objects with their respective statuses.

Use endpoint path below. Base URL is determined by both the target environment and API version.

GET {base_url}/customers/verifications/emails/domains

curl -X GET \
 'https://api.openprovider.eu/v1beta/customers/verifications/emails/domains?domain=test.com' \
 -H 'Authorization: Bearer 2831a37fb8*******90b5aac822' \
 -H 'Content-Type: application/json' \

{
"code": 0,
"desc": "",
"data": {
"results": [
{
"domain": "test.com",
"email": "john@example.com",
"handle": "AB123456-NL",
"status": "failed",
"description": "expired",
"is_suspended": true,
"expiration_date": "0000-00-00 00:00:00"
}
],
"total": 1
}
}