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

# Bouncer

> Connect Bouncer to verify email addresses with high accuracy in your workflows.

## How to set up Bouncer

### Authentication

Bouncer uses API key authentication:

1. Sign up at [usebouncer.com](https://usebouncer.com)
2. Navigate to **API** settings
3. Copy your API key
4. Paste the API key in Cargo when connecting

## Bouncer actions

### Verify email

Validate an email address and check deliverability.

**Required fields:**

* **Email**: The email address to verify

**Credits:** 0.3 credits per verification

## Verification results

Bouncer provides detailed verification statuses:

| Status        | Description                       |
| ------------- | --------------------------------- |
| deliverable   | Email exists and accepts messages |
| undeliverable | Email doesn't exist or bounces    |
| risky         | May bounce - use with caution     |
| unknown       | Couldn't determine status         |

## Response data

Bouncer returns comprehensive verification details:

| Field          | Description                    |
| -------------- | ------------------------------ |
| status         | Overall verification status    |
| reason         | Detailed reason for status     |
| email          | Verified email address         |
| domain         | Email domain                   |
| account        | Email account/username         |
| did\_you\_mean | Suggested typo correction      |
| role           | Is it a role-based email?      |
| free           | Is it a free email provider?   |
| disposable     | Is it a disposable email?      |
| accept\_all    | Does domain accept all emails? |

## Best practices

* Verify at point of capture for immediate feedback
* Re-verify before major campaigns
* Treat "risky" emails with caution - monitor for bounces
* Never email "undeliverable" addresses
* Use disposable email detection to filter low-quality leads
* Leverage "did\_you\_mean" for typo corrections
* Consider role-based emails carefully (info@, support@)

## Why use Bouncer?

* **High accuracy**: Advanced verification technology
* **Fast results**: Real-time verification
* **Detailed insights**: Rich metadata about each email
* **Typo detection**: Automatic correction suggestions
* **Disposable detection**: Identify throwaway emails
* **Role detection**: Identify generic addresses