GET
/
validateEmail
curl --request GET \
  --url https://greipapi.com/validateEmail \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "score": 3,
    "reason": "Invalid email domain.",
    "isValid": false
  },
  "status": "success",
  "executionTime": 10
}

​
Query Parameters

email
string
required

The email command is used to specify the email you want to validate.

Expected values: an email address

Sample 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 Newline

For 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.

​
Response properties

data
object
required
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.

isValid
boolean
required

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

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)
  • Testing the email service provider of a given email address
  • Validation of email syntax

Was this page helpful?

IBAN ValidationPhone Number Validation