Email Validation
GET/emails
Query for and validate email addresses.
Request
Query Parameters
API Key
Your unique identifier that allows access to our APIs.
Begins ak_
. Available from your dashboard
Specifies the email address to validate
A comma separated list of tags to query over.
Useful if you want to specify the circumstances in which the request was made.
If multiple tags are specified, the response will only comprise of requests for which all the tags are satisfied - i.e. searching "foo,bar"
will only query requests which tagged both "foo"
and "bar"
.
Responses
- 200
- 400
- 401
Success
- application/json
- Schema
- Example (from schema)
- Valid Email
Schema
- Email Object
- Unknown Email Object
Possible values: [2000
]
Possible values: [Success
]
result object required
Possible values: [deliverable
, not_deliverable
]
Returns true
if the email can be delivered
Returns true
if email comes from a disposable email service like temp-mail
Returns true
if the email originates from a free service like Outlook or Gmail.
Returns true
if email address represents an organisational role like admin
, support
, postmaster
etc
Returns true
if this domain accepts all emails regardless of username
Possible values: [unknown
]
Possible values: [null
]
Deliverability is not known
Possible values: [null
]
Disposability is not known
Possible values: [null
]
Free email provider is not known
Possible values: [null
]
Role is not known
Possible values: [null
]
Catch-all status is not known
{
"result": {
"result": "deliverable",
"deliverable": true,
"catchall": false,
"free": false,
"role": true,
"disposable": false
},
"code": 2000,
"message": "Success"
}
{
"result": {
"result": "deliverable",
"deliverable": true,
"catchall": false,
"free": false,
"role": true,
"disposable": false
},
"code": 2000,
"message": "Success"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
API Response Code. Non 2xxx
code indicates a failure. This code will provide a more specific reason when a failure occurs and facilitates debugging.
Human readable error message supplied with every error response.
errors object[]
Indicates location of error in request query or URL parameter
Indicates location of error in request query or URL parameter
{
"code": 0,
"message": "string",
"errors": [
{
"message": "should have required property 'type'",
"path": ".query.type",
"errorCode": "required.openapi.validation"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
API Response Code. Non 2xxx
code indicates a failure. This code will provide a more specific reason when a failure occurs and facilitates debugging.
Human readable error message supplied with every error response.
{
"code": 0,
"message": "string"
}