Skip to main content
POST
/
v1.1
/
email
/
verify
/
batch
/
sync
Process with email verification queue
curl --request POST \
  --url https://api.usebouncer.com/v1.1/email/verify/batch/sync \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
[
  "jane@usebouncer.com",
  "john@usebouncer.com"
]
'
[
  {
    "email": "jane@usebouncer.com",
    "status": "undeliverable",
    "reason": "rejected_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": 0,
    "toxic": "unknown",
    "toxicity": 0
  }
]
If you need to verify multiple email addresses in a batch, but you prefer synchronous integrations you can use our Synchronous Batch Email Verification API. Each request adds new emails to batch processing queue, and returns response when result is known. Speed Default settings allow our customers to verify 100k email addresses per hour, however if your use case requires higher throughput, please let us know and we will be able to adjust your configuration. Rate Limiting The Batch Sync Email Verification API is limited to 100 requests per minute by default. Batch size recommendation Single request can hold up to 10,000 emails. Special considerations Requests should be sent sequentially with delay between requests of 5sec to 10min. Results are kept up to 24h in Bouncer. After that delay email will be verified again and credits will be charged.

Authorizations

​
x-api-key
string
header
required

Headers

​
Content-Type
string

Body

application/json
Example:
[
  "jane@usebouncer.com",
  "john@usebouncer.com"
]

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