GET
/
v1.1
/
email
/
verify
{
  "email": "john@usebouncer.com",
  "status": "deliverable",
  "reason": "accepted_email",
  "domain": {
    "name": "usebouncer.com",
    "acceptAll": "no",
    "disposable": "no",
    "free": "no"
  },
  "account": {
    "role": "no",
    "disabled": "no",
    "fullMailbox": "no"
  },
  "dns": {
    "type": "MX",
    "record": "aspmx.l.google.com."
  },
  "provider": "google.com",
  "score": 100,
  "toxic": "unknown",
  "toxicity": 0
}

You can use Bouncer’s Real-time Email Verification API to check email addresses at the moment of entry, and implement it for your sing up forms.

It is a full email verification and email validation method – it not only checks the syntax and domain of the address but also contacts underlying SMTP servers to check deliverability of email addresses.

Bouncer will return best possible results that it will be able to gather within 10 seconds (maximum 30).

This method is recommended when speed of verification is of a value as usually this method returns 5% more “unknown” results than full integration using Batch Email Verification API.

Rate Limiting

Real-Time Email Verification API is limited to 1000 requests per minute by default. Higher limit can be configured in special cases.

Retry After

In cases when we may provide results after greylisting additional parameter “retryAfter” will be added.

Authorizations

​
x-api-key
string
headerrequired

Query Parameters

​
email
string
required

(Required) email

​
timeout
integer
default: 10

timeout for verification (default: 10)

Response

200 - application/json
​
email
string
​
status
string
​
reason
string
​
domain
object
​
account
object
​
dns
object
​
provider
string
​
score
integer
​
toxic
string
​
toxicity
integer
​
retryAfter
string
Check available creditsCreate batch request