GET
/
v1.1
/
email
/
verify
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"
}

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.

Toxicity

When using with-toxicity=true parameter one additional credit will be used.

Authorizations

x-api-key
string
headerrequired

Query Parameters

email
string

(Required) email

with-toxicity
boolean

perform additional toxicity check - one additional credit will be used

timeout
integer

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