SEON user docs logoSEON user docs logoSEON user docs logo
Search input icon

Email Verification API

Our quick email verification tool will tell you whether an email address is valid and deliverable using a  fast SMTP-MX check.

Good to know

  • All SEON API requests are case-sensitive. Please follow the formatting below to avoid errors.
  • Email Verification API requests are limited to 120/minute during your SEON free trial.

Request

The [email_address] in the request URI should include the full email address, for example: example@example.com

 

Optional query string parameters

Add the following parameters to the request URL for more control over the returned data, as seen in the example URL below.

GET

https://api.seon.io/SeonRestService/email-verification/v1.0/[email_address]?include=id

Request Attributes

ValueRequired
include
id no

HTTP Endpoint

GET

https://api.seon.io/SeonRestService/email-verification/v1/[email_address]
PHP
Generic
Generic

Response

The endpoint returns JSON structured response.

JSON Attributes

Type
id
string
valid_format
boolean
deliverable
boolean
inbox_full
boolean
domain_details
object
Response
{
 "success": true,
 "error": {},
 "data": {
  "id": "P100",
  "valid_format": true,
  "deliverable": true,
  "inbox_full": false,
  "domain_details": {
   "domain": "example.com",
   "tld": ".com",
   "registered": true,
   "disposable": false,
   "free": false,
   "custom": true,
   "dmarc_enforced": false,
   "spf_strict": true,
   "valid_mx": true,
   "accept_all": false,
   "suspicious_tld": false,
   "website_exists": true,
   "created": "1994-11-01 05:00:00",
   "updated": "2019-05-07 20:09:37"
  }
 }
}