Usage

Call the email endpoint: POST <https://tools.prod.verisoul.ai/email> with any email string.

Example request

curl --location 'https://tools.prod.verisoul.ai/email' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {your-api-key}' \
--data-raw '{
    "email": "[email protected]"
}'

Example response

{
    "domain": {
        "domain": "verisoul.xyz",
        "is_mx_active": true,
        "is_disposable": false,
        "domain_age_years": 2
    },
    "email": {
        "raw_email": "[email protected]",
        "normalized_email": "[email protected]",
        "is_valid": true,
        "is_personal": false,
        "email_first_seen_years": -1,
        "similar_emails": [
            {
                "email": "[email protected]",
                "score": 1
            }
        ]
    }
}

Optional Timeout

You can provide an optional query parameter timeout which will run some of the API's longer running processes with a configured timeout. By default the API runs with a timeout of 1 second, but it can be set to as low as 300 milliseconds. An example API with a custom timeout:

https://tools.prod.verisoul.ai/email?timeout=300

Response Explained

domain.is_mx_active: Check if the domain contains a valid MX (Mail Exchange) DNS record

domain.is_disposable: Check for a temporary or disposable address

domain.domain_age_years: Estimated age of domain based on WHOIS records . Unknown domain age is returned as -1

email.is_valid: Check if email is proper format

email.is_personal: Check if email is tied to an individual domain or a business/enterprise

email.email_first_seen_years: Estimated age of email based on when it was seen first in public records. Unknown email age is returned as -1

email.similar_emails: Check email against record of already submitted emails to find likely duplicates

• Scores range from 0-1; scores of 1 or near 1 are exact matches, scores above 0.9 are near matches

Demo

Deleting Data

You can delete your emails at any time via API endpoint or through the dashboard (click on the row you want to delete).

Call the email endpoint: DELETE <https://tools.prod.verisoul.ai/email> with a valid email string to delete an email.

Example Request

curl --location --request DELETE 'https://tools.prod.verisoul.ai/email' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {your-api-key}' \
--data-raw '{
    "email": "[email protected]"
}'