# 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:** 20260414_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.

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

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

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

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

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

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

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

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

### Verify Email

**Slug:** `BOUNCER_VERIFY_EMAIL`

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