# Bouncer

Bouncer is an email verification and validation service that helps ensure email deliverability by verifying email addresses through real-time and batch processing APIs.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `BOUNCER`
- **Version:** 20260227_00

## Tools

### Check Toxicity List Job Status

**Slug:** `BOUNCER_CHECK_TOXICITY_LIST_JOB_STATUS`

Tool to check the status of a specific toxicity list job. Use after creating a toxicity list job to poll its status until completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the toxicity list job to query |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Batch Request

**Slug:** `BOUNCER_CREATE_BATCH_REQUEST`

Initiates an asynchronous batch email verification request. Use when you have multiple emails to verify. Returns a batch ID for tracking - use BOUNCER_GET_BATCH_RESULTS to retrieve verification results after processing completes, or provide a callback URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items` | array | Yes | List of email objects to verify in the batch |
| `callback` | string | No | Webhook URL to receive a POST notification when batch processing completes. The callback will include the batchId and final status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Toxicity List Job

**Slug:** `BOUNCER_CREATE_TOXICITY_LIST_JOB`

Tool to create a toxicity analysis job for a list of email addresses. Use when you need to batch-process toxicity checks for multiple emails at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of email addresses to analyze for toxicity |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete batch request

**Slug:** `BOUNCER_DELETE_BATCH_REQUEST`

Deletes a batch email verification request and all associated emails and results. Use when you need to permanently remove batch data. This operation is idempotent - calling it multiple times on the same batch ID is safe and returns success. Data is automatically deleted by Bouncer after 60 days if not deleted manually.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | The unique identifier of the batch to delete. This is the batchId returned when creating a batch request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Toxicity List Job

**Slug:** `BOUNCER_DELETE_TOXICITY_LIST_JOB`

Tool to delete a specific toxicity list job. Use when you need to remove a completed or unwanted toxicity analysis job after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the toxicity list job to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Finish Batch

**Slug:** `BOUNCER_FINISH_BATCH`

Tool to mark a batch verification process as finished early. Use when you need to stop batch processing before all emails are verified and reclaim credits for unprocessed emails. IMPORTANT: The batch must be in 'processing' status - cannot finish a batch that is 'queued' or already 'completed'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | Unique identifier of the batch to finish. Must be a batch currently in 'processing' status. Obtain this ID from the response of a Create Batch Request action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Batch Results

**Slug:** `BOUNCER_GET_BATCH_RESULTS`

Tool to retrieve the results of a batch verification process. Use after submitting a batch to fetch all processed email verification outcomes. Note: If the batch is still processing, the API will return a 405 status indicating results are not yet available. Wait for the batch to complete before retrieving results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | Unique identifier of the batch to retrieve results for. |
| `download` | string ("all" | "deliverable" | "risky" | "undeliverable" | "unknown") | No | Filter which email statuses to include in results; one of: 'all', 'deliverable', 'risky', 'undeliverable', 'unknown'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credits

**Slug:** `BOUNCER_GET_CREDITS`

Tool to retrieve the current credit balance for the account. Use when you need to check available credits before performing verification operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Domain

**Slug:** `BOUNCER_VERIFY_DOMAIN`

Tool to verify the validity and configuration of a domain. Use when you need to confirm the domain's MX records and catch-all behavior.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Domain name to verify (e.g., 'usebouncer.com'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Email

**Slug:** `BOUNCER_VERIFY_EMAIL`

Tool to verify a single email address in real-time. Use when validating email entry form inputs instantly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify in real-time. |
| `timeout` | integer | No | Timeout for verification in seconds (default: 10). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |