> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bounceban API Guide for GTM Workflows

> Use BounceBan as the final email deliverability gate, especially for accept-all addresses. Includes inputs, outputs, costs, and Deepline CLI examples.

## Playbook

# BounceBan Guidance

Use BounceBan to verify email deliverability, particularly when an address may be accept-all or protected by a secure email gateway.

* Use `bounceban_verify_single` for a single email. It may return `status: verifying`; poll `bounceban_get_single_status` with the returned id instead of submitting it again.
* Use `bounceban_verify_bulk` to create a batch from known email addresses. Poll its status and then retrieve results with the bulk result actions.
* The account and result retrieval actions are free. Do not submit an address again while its verification is still running.
* The waterfall endpoint is not available yet: its documented HTTP 408 can retain a billable task, which needs a non-2xx async settlement path in the shared V2 runtime.