BounceBan
Verify catch-all and SEG-protected emails.
SourcingManaged12 endpoints
Runtime credentials
Connecting BounceBan via OAuth or your own API key requires the following secret slots in your workspace:
- BOUNCEBAN_API_KEY
Endpoints
| Operation | Method & path | Effect | Latency | Rate | Cost |
|---|---|---|---|---|---|
get_account Get the BounceBan account credit balance and per-endpoint rate limits. docs ↗ | GET /v1/account | none | <1s | — | no bill |
verify_single_waterfall Resolve whether a catch-all / accept-all / SEG-protected email is actually deliverable, synchronously, in a single request. docs ↗ | GET /v1/verify/single | paid_provider | 5-30s | 25/s | 0-0.75 credits |
verify_single Verify one email with BounceBan's standard single verifier (15s timeout; returns a task id with status 'verifying' to poll when slower). docs ↗ | GET /v1/verify/single | paid_provider | async-poll | — | 0-0.75 credits |
get_single_status Poll the result of a single email verification task by id. Free; does not consume credits. docs ↗ | GET /v1/verify/single/status | none | <1s | — | no bill |
verify_bulk Verify a large list of emails asynchronously in one BounceBan task, then poll for results. docs ↗ | POST /v1/verify/bulk | paid_provider | async-poll | 3/s | 0-0.75 credits |
verify_bulk_file Create a bulk verification task by uploading a CSV file (multipart). Original columns are preserved for export. docs ↗ | POST /v1/verify/bulk/file | paid_provider | async-poll | — | 0-0.75 credits |
get_bulk_status Get progress and result counts for a bulk verification task. Free; does not consume credits. docs ↗ | GET /v1/verify/bulk/status | none | <1s | — | no bill |
get_bulk_emails Fetch verification results for up to 100 specific emails from a bulk task. Free; does not consume credits. docs ↗ | POST /v1/verify/bulk/emails | none | <1s | — | no bill |
get_bulk_dump Retrieve bulk verification results as paginated JSON (optionally filtered by result state). Free; does not consume credits. docs ↗ | GET /v1/verify/bulk/dump | none | 1-5s | — | no bill |
export_bulk Export a finished bulk verification task to a downloadable CSV link (expires after 4 hours). Free; does not consume credits. docs ↗ | POST /v1/verify/bulk/export | none | 1-5s | — | no bill |
destroy_bulk Permanently delete a bulk verification task and all its data by id. Free; irreversible. docs ↗ | POST /v1/verify/bulk/destroy | external_send | <1s | — | no bill |
check Quickly check an email or domain: domain type (work/free/disposable), username type (personal/role), and syntax validity. docs ↗ | GET /v1/check | paid_provider | <1s | — | 0-0.75 credits |