> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

![Bouncer logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/bouncer.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=2a6ca2a20c556d5b13a23031632ad75a)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `BOUNCER`
* **Version:** 20261101\_00

## Tools

> [accordion] 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
>
> **id** `string` *required*
>
> Unique identifier of the toxicity list job to query
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **items** `array` *required*
>
> List of email objects to verify in the batch
>
> **callback** `string`
>
> Webhook URL to receive a POST notification when batch processing completes. The callback will include the batchId and final status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **emails** `array` *required*
>
> List of email addresses to analyze for toxicity
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete batch request
>
> **Slug:** `BOUNCER_DELETE_BATCH_REQUEST`
>
> Deletes a batch email verification request and its associated emails and results by batch ID. Bouncer automatically deletes batch data after 60 days if it is not deleted manually; a batch not found response is reported as an error.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> The unique identifier of the batch to delete. This is the batchId returned when creating a batch request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **id** `string` *required*
>
> The unique identifier of the toxicity list job to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **batch\_id** `string` *required*
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch Results
>
> **Slug:** `BOUNCER_GET_BATCH_RESULTS`
>
> Retrieves email verification results for a batch, optionally filtering by verification status. Wait for the batch to complete before retrieving results; a 405 response indicating that the batch is not completed is reported as an error.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> Unique identifier of the batch to retrieve results for.
>
> **download** `string ("all" | "deliverable" | "risky" | "undeliverable" | "unknown")`
>
> Filter which email statuses to include in results; one of: 'all', 'deliverable', 'risky', 'undeliverable', 'unknown'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **domain** `string` *required*
>
> Domain name to verify (e.g., 'usebouncer.com').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Email
>
> **Slug:** `BOUNCER_VERIFY_EMAIL`
>
> Verifies a single email address in real time to assess its deliverability, for example when validating a form entry. Returns a verification status and reason, with additional details when available; the verification timeout can be specified.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to verify in real-time.
>
> **timeout** `integer`
>
> Timeout for verification in seconds (default: 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
