Skip to main content
GET
/
v1.1
/
email
/
verify
Verify email
curl --request GET \
  --url https://api.usebouncer.com/v1.1/email/verify \
  --header 'x-api-key: <api-key>'
{
  "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 sign 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 the 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
header
required

Query Parameters

​
email
string
required

(Required) email

​
timeout
integer
default:10

timeout for verification (default: 10)

Response

OK

​
email
string
required
​
status
enum<string>
required
Available options:
deliverable,
risky,
undeliverable,
unknown
​
reason
enum<string>
required
Available options:
accepted_email,
low_deliverability,
low_quality,
invalid_email,
invalid_domain,
rejected_email,
dns_error,
unavailable_smtp,
unsupported,
timeout,
unknown
​
domain
object
​
account
object
​
dns
object
​
provider
string
​
score
integer
Required range: 0 <= x <= 100
​
toxic
string
​
toxicity
integer
Required range: 0 <= x <= 5
​
retryAfter
string