Skip to main content
POST
/
api
/
v1
/
verify
curl -X POST "https://api.bouncedetector.com/api/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

{
  "email": "user@example.com",
  "valid": true,
  "deliverable": true,
  "acceptAll": false,
  "role": false,
  "temporary": false,
  "mx": true,
  "smtp": true,
  "score": 100
}
Verify one email address. Uses MX, SMTP, disposable, and role-based checks. Results are cached for 90 days unless noCache is true.

​
Request

​
email
string
required
Email address to verify
​
noCache
boolean
If true, always run verification and ignore cache. Default false.

​
Response

​
email
string
Verified email address
​
valid
boolean
Passes syntax and basic checks
​
deliverable
boolean
Mailbox appears deliverable
​
acceptAll
boolean
Domain accepts all addresses
​
role
boolean
Role-based address (e.g. info@, support@)
​
temporary
boolean
Disposable/temporary email
​
mx
boolean
Has valid MX records
​
smtp
boolean
SMTP check succeeded
​
score
number
0–100 deliverability score
curl -X POST "https://api.bouncedetector.com/api/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

{
  "email": "user@example.com",
  "valid": true,
  "deliverable": true,
  "acceptAll": false,
  "role": false,
  "temporary": false,
  "mx": true,
  "smtp": true,
  "score": 100
}

Authorizations

​
Authorization
string
header
required

Your API key (e.g. bdt_abc123...). Obtain from the dashboard.

Body

application/json
​
email
string<email>
required
Example:

"user@example.com"

​
noCache
boolean
default:false

If true, always run verification and ignore cache.

Response

Verification result

​
email
string
​
valid
boolean
​
deliverable
boolean
​
acceptAll
boolean
​
role
boolean
​
temporary
boolean
​
mx
boolean
​
smtp
boolean
​
score
number
Last modified on March 9, 2026