Email Verification API

The Beltic Email Verification API estimates deliverability rates by detecting invalid mailboxes as well as disposable and fraudulent email addresses, spam traps, bounced delivery, and honeypots via our simple-to-use Email Reputation API. Verify email addresses and identify abusive emails & invalid addresses in real-time with a reliable, low-latency API request.

Adding the Email Verification API to your registration and checkout pages allows you to validate email addresses in real-time as users interact with your site or app. This proactive approach helps prevent the creation of fake accounts, typos, bounces, invalid user data, and other forms of abuse.

What is an Email Verification API?

The Beltic email verification API validates email addresses through on-demand lookups to mailbox providers such as Gmail.com, Yahoo.com, and Hotmail.com. Append important data to any email address, including identity details, fraud scores, validation status, spam trap detection, and even disposable email detection.

How Does Email Verification Work?

Our email checker technology performs the email verification process through deep checks that look at an email address from all angles. It features advanced mailbox verification checks for issues like spam traps, catch-all domains, syntax errors, invalid addresses, and other types of incorrect email addresses.

Email Verification API Use Cases

Low-Quality Users: Identify duplicate user accounts, bogus user information, and fake registrations to automatically prevent low-quality users from hurting your ROI.

Hard Bounce: Prevent hard bounces by pre-screening email addresses before messaging them.

Disposable Email Services: Easily block disposable email addresses and temporary mail services that allow fraudsters to spawn new emails at any time.

Email Risk Analysis & Fraud Prevention

Analyze email address reputation in real-time with email risk analysis, including the email account creation date using an estimate of the email age based on when Beltic first discovered the account.

Beltic provides advanced email address fraud prevention to validate new users, logins, and payments. In addition to detecting disposable email services and parked domains, Beltic can also identify perfectly valid email addresses that have recently engaged in abusive behavior. Beltic can detect email addresses recently involved with chargebacks, fake account creation, account takeover, SPAM, trial abuse, and high-risk behavior through our honeypot threat network and partner feedback program.

Endpoint

POST https://api.beltic.com/v1/emails/risk

Parameters

Authentication

Include your API key in the request header:

X-Api-Key: your_api_key_here

Example Request

curl --location 'https://api.beltic.com/v1/emails/risk' \
--header 'X-Api-Key: ApiKey' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "name@example.com"
}'

Example Response

{
    "email": {
        "sanitized_email": "name@example.com",
        "valid": true,
        "first_name": "Unknown",
        "generic": false,
        "common": true,
        "suggested_domain": null
    },
    "deliverability": {
        "deliverability": "high",
        "smtp_score": 3,
        "dns_valid": true,
        "catch_all": false,
        "timed_out": false
    },
    "risk": {
        "overall_score": 4,
        "fraud_score": 0,
        "recent_abuse": false,
        "suspect": false,
        "disposable": false,
        "leaked": true,
        "risky_tld": false,
        "spam_trap_score": "none",
        "frequent_complainer": false
    },
    "auth": {
        "spf_record": true,
        "dmarc_record": true
    },
    "records": {
        "mx_records": [
            "alt4.gmail-smtp-in.l.google.com",
            "alt2.gmail-smtp-in.l.google.com",
            "alt3.gmail-smtp-in.l.google.com",
            "alt1.gmail-smtp-in.l.google.com",
            "gmail-smtp-in.l.google.com"
        ],
        "a_records": [
            "142.250.73.69",
            "142.250.69.165"
        ]
    },
    "timeline": {
        "domain_age": "1995-08-13T00:00:00-04:00",
        "first_seen": "2017-01-01T01:01:01-05:00"
    }
}

Response Field Definitions

The Beltic Email Verification API returns comprehensive data with each lookup to help your development team make informed decisions in your business logic. The "Fraud Score" provides valuable insights to identify high-risk emails and mail providers. The "User Activity" signal estimates legitimate behavior associated with the email, such as purchases and account registrations. The "First Seen" date estimates how old the email address is, indicating newly created accounts.

Recommended Logic for API Results

Treat email addresses as valid when:

• For email marketing and delivery analysis: valid is true, disposable is false, and spam_trap_score is not high
• For stricter email marketing deliverability: Scrub records with spam_trap_score as medium. For even stricter filtering, scrub emails with frequent_complainer as true
• For user quality analysis: valid is true, disposable is false, and fraud_score is less than 90

Fraud Scores can also be a good indicator of user quality, where scores 80+ are suspicious and 90+ are risky. To prevent against account takeover and credential stuffing, emails with "leaked" as true indicate user data recently compromised on the dark web.

Complete Field Reference

The API response is organized into the following main objects:

Email Object

Deliverability Object

Risk Object

Auth Object

Records Object

Timeline Object

Error Responses

400 Bad Request

{
    "error": "Invalid email format",
    "message": "Email address must be in valid format"
}

401 Unauthorized

{
    "error": "Unauthorized",
    "message": "Invalid or missing API key"
}