Skip to main content
GET
/
v1.1
/
email
/
verify
/
batch
/
{batchId}
/
download
Get results
curl --request GET \
  --url https://api.usebouncer.com/v1.1/email/verify/batch/{batchId}/download \
  --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
  },
  {
    "email": "jane@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
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.usebouncer.com/llms.txt

Use this file to discover all available pages before exploring further.

By default results are downloaded in JSON format. CSV format support Results can also be downloaded as CSV file by passing ‘Accept’ header. 
curl https://api.usebouncer.com/v1.1/email/verify/batch/<BATCH_ID>/download \
  -H "x-api-key: <api-key>" \
  -H 'Accept: text/csv'

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
batchId
string
required

Query Parameters

​
download
string

download emails by status, possible values: all, deliverable, risky, undeliverable, unknown

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