> ## 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.

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# 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