> ## Documentation Index
> Fetch the complete documentation index at: https://docs.greip.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Email Scoring
> This method provides an additional layer of validation for your system. While validating email syntax is important, it is not sufficient.
This method goes beyond syntax validation by checking the domain's validity, the availability of the Mail Service, detecting Disposable Email (Temporary Emails), etc. By utilising this method, you can ensure a more thorough validation process for email addresses.
export const MCPCallout = () => {
return
;
};
### Query Parameters
The email command is used to specify the email you want to validate.
Expected values: an email address
Sample value: `name@domain.com`
The format command is used to get a response in a specific format.
Expected values: `JSON`, `XML`, `CSV`, or `Newline`
For more information please refer to [Response Format](/options/response-format).
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](/options/development-environment).
The userID command can be used to identify requests sent by specific users to monitor in the [Events Page](/dashboard-guides/monitoring-capabilities/real-time-threat-monitoring).
Expected values: email address, phone number, user id, name, etc.
For more information please refer to [User Identifier](/options/user-identifier).
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](/options/jsonp-callback).
```json Success theme={null}
{
"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
}
```
```json Error theme={null}
{
"status": "error",
"code": 101,
"type": "invalid_key",
"description": "The API Key is missing or invalid."
}
```
### Response properties
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).
The reason behind considering this email address as risky.
**Note:** The value of this property will be empty if the `score` is `0`.
Indicates whether the email address is from a free email service provider.
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.
Indicates whether the email address is an educational email address.
A boolean value that you can rely on to determine if the email address is 100% safe & valid or not.
Indicates whether the email address is a disposable email address (also known as Temporary Email Addresses).
Indicates if the email/domain is blacklisted due to applying [custom
rules](/knowledge-base/custom-rules/overview) or were found in one of your
blacklists.
The information associated with the domain name of the email address.
The full domain name associated with the email address (for example, `gmail.com`).
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.
Indicates whether the domain has a valid SPF (Sender Policy Framework) record, which helps prevent email spoofing.
Indicates whether the domain has a valid DMARC (Domain-based Message Authentication, Reporting, and Conformance) record, which helps protect against email phishing and spoofing.
Indicates whether the domain has a valid DKIM (DomainKeys Identified Mail) record, which verifies the authenticity of the sender's domain.
Indicates whether the domain has valid MX (Mail Exchange) records, confirming that it is capable of receiving emails.
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.
The date when the domain was first registered or created, if available.
Indicates whether the domain is new or recently registered (registered within 1 year), which may affect its reputation and trustworthiness.
The custom rules applied to this request, [learn
more](/knowledge-base/custom-rules/overview).
The total number of custom rules applied to this request.
The custom rules applied to this request, [learn
more](/knowledge-base/custom-rules/overview).
The rule ID as shown in the dashboard (e.g: `CR104`).
The rule title you set when creating the rule.
The response status.
Expected values: `success`, or `error`.
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