API Documentation

Base URL: https://bounceverify.com

Authentication

Free tier requires no auth for single verification. For bulk operations and higher limits, include your API key:

Authorization: Bearer YOUR_API_KEY

Endpoints

Status Codes

200Request successful

400Invalid input or no emails found

401Missing or invalid API key

429Too many requests, slow down

500Internal error, retry later

POST/api/verify/single

Verify Single Email

Verify a single email address with full 6-layer analysis. Returns detailed results including score, status, and risk flags.

Request

curl -X POST https://bounceverify.com/api/verify/single \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"email": "john@example.com"}'

Response

200 OK

{
  "email": "john@example.com",
  "status": "valid",
  "score": 85,
  "syntax_valid": true,
  "domain_exists": true,
  "mx_found": true,
  "smtp_valid": true,
  "is_catch_all": false,
  "is_disposable": false,
  "is_role_based": false,
  "is_free_provider": true,
  "risk_type": "none",
  "mx_records": ["alt1.gmail-smtp-in.l.google.com"],
  "reason": "Email address is valid and deliverable"
}