Want to skip the docs? Use the MCP Server
Endpoint availability: Premium and aboveLearn more
{
"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
}
Email Scoring
curl --request GET \
--url https://greipapi.com/scoring/email \
--header 'Authorization: Bearer <token>'{
"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
}
Risk Scoring
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.
Want to skip the docs? Use the MCP Server
Endpoint availability: Premium and aboveLearn more
{
"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
}
GET
/
scoring
/
email
Email Scoring
curl --request GET \
--url https://greipapi.com/scoring/email \
--header 'Authorization: Bearer <token>'{
"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
}
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.
Query Parameters
The email command is used to specify the email you want to validate.Expected values: an email addressSample value:
name@domain.comThe 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.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.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.
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.Response properties
Hide properties
Hide 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 or were found in one of your
blacklists.
The information associated with the domain name of the email address.
Hide properties
Hide properties
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.
Hide properties
Hide properties
The total number of custom rules applied to this request.
The custom rules applied to this request, learn
more.
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
Was this page helpful?
⌘I