Email Scoring

Query Parameters

string

required

The email command is used to specify the email you want to validate.Expected values: an email addressSample value: name@domain.com

format

string

default:"JSON"

The format command is used to get a response in a specific format.Expected values: JSON, XML, CSV, or NewlineFor more information please refer to Response Format.

mode

string

default:"live"

The mode command is used to in the development stage to simulate the integration process before releasing it to the production environment.Expected values: live, or test.For more information please refer to Development Environment.

userID

string

The userID command can be used to identify requests sent by specific users to monitor in the Events Page.Expected values: email address, phone number, user id, name, etc.For more information please refer to User Identifier.

callback

string

The callback command can help you make the response as a JSONP format.Expected values: any name that can be used as a function name in Javascript, e.g: myFunctionName.For more information please refer to JSONP Callback.

{
  "data": {
    "score": 3,
    "reason": "Email domain is considered dangerous.",
    "isValid": false,
    "isFree": false,
    "isRoleBased": true,
    "isEducational": false,
    "isDisposable": false,
    "blacklisted": false,
    "email": "test@dangerous-domain.com",
    "domain": {
      "name": "dangerous-domain.com",
      "is_dangerous": true,
      "is_spf": false,
      "is_dmarc": false,
      "is_dkim": false,
      "is_mx": false,
      "is_bimi": false,
      "created_at": "2025-02-05",
      "is_new": true
    },
    "custom_rules_applied": { "total": 0, "rules": [] }
  },
  "status": "success",
  "executionTime": 1
}

Response properties

data

object

required

Hide properties

score

integer

required

A risk-score from 0 to 3 indicating how risky this email address is (0=safe, 1=low-risk, 2=high-risk, 3=too-risky).

reason

string

required

The reason behind considering this email address as risky.Note: The value of this property will be empty if the score is 0.

isFree

boolean

required

Indicates whether the email address is from a free email service provider.

isRoleBased

boolean

required

Indicates whether the email address is a role-based email address. Role-based email addresses are those that are associated with a particular role or group, such as admin, support, info, etc.

isEducational

boolean

required

Indicates whether the email address is an educational email address.

isValid

boolean

required

A boolean value that you can rely on to determine if the email address is 100% safe & valid or not.

isDisposable

boolean

required

Indicates whether the email address is a disposable email address (also known as Temporary Email Addresses).

blacklisted

boolean

required

Indicates if the email/domain is blacklisted due to applying custom rules or were found in one of your blacklists.

domain

object

The information associated with the domain name of the email address.

Hide properties

name

string

required

The full domain name associated with the email address (for example, gmail.com).

is_dangerous

boolean|null

required

Indicates whether the domain is flagged as dangerous or suspicious, which may suggest a higher risk of fraud or abuse.

If this property is set to true, the domain is considered high-risk or potentially malicious. As a result, the isValid property will also be false, indicating that the email address should not be trusted for critical communications or user registrations. It is strongly recommended to block or flag such email addresses in your application workflow.

is_spf

boolean|null

required

Indicates whether the domain has a valid SPF (Sender Policy Framework) record, which helps prevent email spoofing.

is_dmarc

boolean|null

required

Indicates whether the domain has a valid DMARC (Domain-based Message Authentication, Reporting, and Conformance) record, which helps protect against email phishing and spoofing.

is_dkim

boolean|null

required

Indicates whether the domain has a valid DKIM (DomainKeys Identified Mail) record, which verifies the authenticity of the sender’s domain.

is_mx

boolean|null

required

Indicates whether the domain has valid MX (Mail Exchange) records, confirming that it is capable of receiving emails.

is_bimi

boolean|null

required

Indicates whether the domain has a valid BIMI (Brand Indicators for Message Identification) record, which allows brand logos to be displayed in supported email clients.

created_at

string|null

required

The date when the domain was first registered or created, if available.

is_new

boolean|null

required

Indicates whether the domain is new or recently registered (registered within 1 year), which may affect its reputation and trustworthiness.

custom_rules_applied

object

The custom rules applied to this request, learn more.

Hide properties

total

integer

required

The total number of custom rules applied to this request.

rules

object

required

The custom rules applied to this request, learn more.

Hide properties

string

required

The rule ID as shown in the dashboard (e.g: CR104).

title

string

required

The rule title you set when creating the rule.

status

string

required

The response status.Expected values: success, or error.

executionTime

integer

required

Time spent in milliseconds to process the data.

What can I expect from this API?

Detection of disposable email addresses (also known as Temporary Email Addresses)
Detection of free email service providers
Detection of role-based email addresses
Testing the email service provider of a given email address
Validation of email syntax

Data Lookup

Risk Scoring

Account Management

Query Parameters

Response properties

What can I expect from this API?

Data Lookup

Risk Scoring

Account Management

​Query Parameters

​Response properties

​What can I expect from this API?

Query Parameters

Response properties

What can I expect from this API?