GET
/
v1.1
/
email
/
verify
/
batch
/
{batchId}
/
download
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
  }
]

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

200
application/json
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 <= 100
​
retryAfter
string