# BounceBan

> BounceBan is an email verification API service. It verifies all kinds of emails and specializes in accept-all (catch-all) emails and emails protected by SEGs (Secure Email Gateways) - identifying which accept-all emails are actually deliverable instead of marking them all as risky. Base URL: https://api.bounceban.com. Auth: put your API key in the `Authorization` header (no Bearer prefix). Each verification costs 1 credit. Results: deliverable / risky / undeliverable / unknown, plus a 0-100 deliverability score.

Key facts for agents:

- Get an API key: https://bounceban.com/app/api/settings
- For Clay, n8n, and other single-request (waterfall) integrations, use `GET https://api-waterfall.bounceban.com/v1/verify/single` - it holds the connection until the result is ready; on HTTP 408 just retry (free within 30 minutes).
- The standard `GET /v1/verify/single` has a 15-second window; if the result isn't ready it returns `status: "verifying"` with an `id` - poll `GET /v1/verify/single/status` (free, max 10 polls per id per 5 minutes) or use a webhook. Never resubmit while verifying: every submit costs 1 credit.
- Bulk flow: `POST /v1/verify/bulk` (or `/bulk/file` for CSV) -> poll `GET /v1/verify/bulk/status` or use the `url_finished` webhook -> fetch results with `GET /v1/verify/bulk/dump` (cursor pagination) or `POST /v1/verify/bulk/export` (CSV link, expires in 4 h).
- Results are retained for 90 days.

## Docs

- [Introduction](https://bounceban.com/public/doc/md/introduction.md): Authentication, base URLs, credits, verification results and modes, rate limits, endpoint selection guide.
- [Single Verification](https://bounceban.com/public/doc/md/single-verification.md): Verify one email - waterfall endpoint (Clay/n8n), standard async endpoint, and result polling.
- [Bulk Verification](https://bounceban.com/public/doc/md/bulk-verification.md): Create bulk tasks from a list or CSV file, track status, fetch results as JSON or CSV, delete tasks.
- [Check API](https://bounceban.com/public/doc/md/check.md): Fast email/domain checks without SMTP verification - domain type, role vs personal, syntax validity.
- [Account API](https://bounceban.com/public/doc/md/account.md): Get credits balance and per-endpoint rate limits.
- [Webhooks](https://bounceban.com/public/doc/md/webhooks.md): Event types, headers, retry behavior, and JSON payload examples for all webhook events.

## Reference

- [Full documentation (single file)](https://bounceban.com/public/doc/llms-full.txt): All of the above concatenated - fetch this if you need everything at once.
- [OpenAPI 3.0 spec](https://bounceban.com/public/doc/api.yaml): Machine-readable API specification.
- [Interactive API reference](https://bounceban.com/public/doc/api.html): Redoc-rendered HTML documentation.
- [Postman workspace](https://www.postman.com/galactic-comet-480286/workspace/bounceban-developers): Test the APIs in a public Postman workspace.

## Support

- [Support center](https://support.bounceban.com): Tutorials, including Clay and n8n integration guides.
- [Pricing](https://bounceban.com/pricing): Buy credits. Test credits: email dev@bounceban.com.
- [Request higher rate limits](https://forms.gle/3De4UMZKpxPiPv5M8): Google form for rate limit increases.