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

# ZeroBounce

> ZeroBounce is an email validation and deliverability platform that helps businesses improve email marketing performance by identifying and removing invalid or risky email addresses.

![ZeroBounce logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/zerobounce.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=4b302d01ea984057d529066001e6170e)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 22
* **Triggers:** 0
* **Slug:** `ZEROBOUNCE`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Get Activity Data
>
> **Slug:** `ZEROBOUNCE_ACTIVITY_DATA`
>
> Tool to get activity data (opens, clicks, etc.) for a given email. Use after confirming the email address to gauge engagement recency.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.019 per matched Activity Data record.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to retrieve activity data for.
>
> #### 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] AI Scoring Single Email
>
> **Slug:** `ZEROBOUNCE_AI_SCORING_SINGLE`
>
> Tool to score a single email address using ZeroBounce AI. Use when you need real-time email lead quality feedback before outreach. Example prompt: "Score the email [mark@gmail.com](mailto:mark@gmail.com)."
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per email scored.
>
> **Discount:** 83
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to retrieve an AI-generated quality score for.
>
> #### 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] Allow or Block List
>
> **Slug:** `ZEROBOUNCE_ALLOW_BLOCK_LIST`
>
> Tool to manage allowlist and blocklist for email validation. Use when you need to programmatically add or modify custom filters before validating emails.
>
> #### Input Parameters
>
> **rule** `string ("allow" | "block")` *required*
>
> Action for the filter: 'allow' to whitelist, 'block' to blacklist.
>
> **value** `string` *required*
>
> The email, domain, MX record, or TLD to filter.
>
> **target** `string ("email" | "domain" | "mx" | "tld")` *required*
>
> Level to apply the filter: 'email', 'domain', 'mx', or 'tld'.
>
> #### 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] Batch Validate Emails
>
> **Slug:** `ZEROBOUNCE_BATCH_VALIDATE_EMAILS`
>
> Validate up to 200 email addresses in a real-time batch, with optional activity data on non-managed connections. Managed batch validation supports base validation only.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per email validated; unknown results are free.
>
> **Discount:** 83
>
> #### Input Parameters
>
> **api\_key** `string`
>
> API key for authentication, automatically added
>
> **timeout** `integer`
>
> Timeout in seconds (10–120). If exceeded, emails marked unknown/greylisted
>
> **email\_batch** `array` *required*
>
> List of up to 200 email objects to validate
>
> **verify\_plus** `boolean`
>
> Use Verify+ validation method (overrides account setting)
>
> **activity\_data** `boolean`
>
> Include activity data in the validation results
>
> #### 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 AI Scoring File
>
> **Slug:** `ZEROBOUNCE_DELETE_AI_SCORING_FILE`
>
> Tool to remove a completed AI scoring file from ZeroBounce servers. Use when the file status is 'Complete' and you need to remove it.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The file ID returned from scoring sendfile API. Files can only be deleted when their status is Complete.
>
> #### 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 file
>
> **Slug:** `ZEROBOUNCE_DELETE_FILE`
>
> Tool to delete a file that was submitted for bulk validation. Use when file status is 'Complete'.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The file ID returned when uploading via sendfile API.
>
> #### 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] Domain Search File Status
>
> **Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_FILE_STATUS`
>
> Tool to get the processing status of a file submitted for bulk domain search. Use after submitting the file to poll status.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the domain search job returned by the sendfile API.
>
> #### 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] Domain Search Get File
>
> **Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_GET_FILE`
>
> Tool to download the results file for a completed bulk domain search job. Use when you have the file\_id and the job is complete.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the domain search job returned by the sendfile API.
>
> #### 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] Domain Search Send File
>
> **Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_SEND_FILE`
>
> Tool to upload a file for bulk domain search. Use when you have many domains in a CSV/TXT and need to lookup their details in bulk.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> CSV or TXT file to upload for bulk domain search. The file should contain a list of domains to search.
>
> **domain\_column** `integer` *required*
>
> 1-based index of the column containing domains in the file.
>
> **has\_header\_row** `boolean`
>
> Whether the first row of the file is a header row.
>
> #### 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] Domain Search Single
>
> **Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_SINGLE`
>
> Identify common email address formats for a domain or company name. Non-managed requests can also include a person's name for a more specific match.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.39 per email format found; free if none is found.
>
> #### Input Parameters
>
> **domain** `string`
>
> The email domain to search (e.g., 'example.com')
>
> **last\_name** `string`
>
> Person's last name for more specific email format matching
>
> **first\_name** `string`
>
> Person's first name for more specific email format matching
>
> **middle\_name** `string`
>
> Person's middle name for more specific email format matching
>
> **company\_name** `string`
>
> The company name to search if domain is not known (e.g., 'Example Inc')
>
> #### 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 Email Finder File
>
> **Slug:** `ZEROBOUNCE_EMAIL_FINDER_DELETE_FILE`
>
> Tool to delete a file that was submitted for bulk email finding. Use when the file processing status is 'Complete' and you need to remove it.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file to delete, returned by the email finder sendfile API
>
> #### 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] Email Finder File Status
>
> **Slug:** `ZEROBOUNCE_EMAIL_FINDER_FILE_STATUS`
>
> Get the processing status and progress of a file submitted for bulk email finding, using its file ID. Use this to poll an upload; a file that cannot be found is reported as an error.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The file ID returned by the Email Finder send file API
>
> #### 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] Email Finder Send File
>
> **Slug:** `ZEROBOUNCE_EMAIL_FINDER_SEND_FILE`
>
> Tool to upload a file for bulk email finding. Use when you have lists of names and domains to find emails in bulk via CSV/TXT upload.
>
> #### Input Parameters
>
> **file** `string` *required*
>
> Raw contents of the CSV or TXT file to upload.
>
> **file\_name** `string` *required*
>
> Filename including extension (e.g., 'emails.csv').
>
> **domain\_column** `integer` *required*
>
> 1-based index of the column containing domains in the file.
>
> **has\_header\_row** `boolean`
>
> Whether the first row of the file is a header row.
>
> **full\_name\_column** `integer`
>
> 1-based index of the full name column. Either this or first\_name\_column is required.
>
> **last\_name\_column** `integer`
>
> 1-based index of the last name column (optional).
>
> **first\_name\_column** `integer`
>
> 1-based index of the first name column. Either this or full\_name\_column is required.
>
> **middle\_name\_column** `integer`
>
> 1-based index of the middle name column (optional).
>
> #### 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 API Usage
>
> **Slug:** `ZEROBOUNCE_GET_API_USAGE`
>
> Tool to retrieve API usage statistics for a given period. Use when you need usage metrics between two dates.
>
> #### Input Parameters
>
> **end\_date** `string` *required*
>
> End date of query in YYYY-MM-DD format.
>
> **start\_date** `string` *required*
>
> Start date of query in YYYY-MM-DD format.
>
> #### 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 Credit Balance
>
> **Slug:** `ZEROBOUNCE_GET_CREDIT_BALANCE`
>
> Tool to retrieve your current ZeroBounce email validation credit balance. Use when you need to monitor remaining credits to avoid service interruptions.
>
> #### 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 Email Finder File
>
> **Slug:** `ZEROBOUNCE_GET_EMAIL_FINDER_FILE`
>
> Tool to download the results file for a completed bulk email finder job. Use when you have the file\_id and the job is complete.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The file ID returned when calling email-finder/sendfile
>
> #### 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 File
>
> **Slug:** `ZEROBOUNCE_GET_VALIDATION_FILE`
>
> Download results for a completed primary bulk email-validation file. This read is free; processing the uploaded file is charged per email. Bulk files are limited to 50 MB and 1,000,000 records. First poll ZEROBOUNCE\_GET\_VALIDATION\_FILE\_STATUS no faster than five requests per minute (at least 12 seconds apart), and download only after file\_status is Complete. This endpoint shares the five-requests-per-minute bulk limit.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The completed bulk-validation file ID returned by ZEROBOUNCE\_SEND\_FILE.
>
> #### 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] File Status
>
> **Slug:** `ZEROBOUNCE_GET_VALIDATION_FILE_STATUS`
>
> Read processing status for a primary bulk email-validation file. This read is free; processing the uploaded file is charged per email. Bulk files are limited to 50 MB and 1,000,000 records. Poll no faster than the bulk API limit of five requests per minute (at least 12 seconds apart), and call ZEROBOUNCE\_GET\_VALIDATION\_FILE only after file\_status is Complete.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The bulk-validation file ID returned by ZEROBOUNCE\_SEND\_FILE.
>
> #### 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] List Evaluator
>
> **Slug:** `ZEROBOUNCE_LIST_EVALUATOR`
>
> Upload an email list for a quality health check before full validation. Managed evaluation requires a UTF-8 CSV or TXT file of at most 1 MiB containing 100–1,000 email rows.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **file** `string` *required*
>
> Raw contents of the CSV or TXT file to upload.
>
> **file\_name** `string` *required*
>
> Filename including extension (e.g., 'emails.csv').
>
> **email\_address\_column** `integer` *required*
>
> 1-based index of the column containing email addresses.
>
> #### 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] List Filters
>
> **Slug:** `ZEROBOUNCE_LIST_FILTERS`
>
> Retrieve allowlist and blocklist filter rules for email addresses, domains, MX records, and top-level domains. Use to view or audit current filter rules before validation.
>
> #### 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] Send File
>
> **Slug:** `ZEROBOUNCE_SEND_FILE`
>
> Tool to upload a file for bulk email validation. Use when you need to validate large lists of emails via CSV or TXT file.
>
> #### Input Parameters
>
> **file** `string` *required*
>
> Raw contents of the CSV or TXT file to upload.
>
> **file\_name** `string` *required*
>
> Filename including extension (e.g., 'emails.csv').
>
> **return\_url** `string`
>
> Callback URL to receive notification when file processing is complete (optional).
>
> **gender\_column** `integer`
>
> 1-based index of the column containing gender in the file (optional).
>
> **has\_header\_row** `boolean`
>
> Whether the first row of the file is a header row.
>
> **last\_name\_column** `integer`
>
> 1-based index of the column containing the last name in the file (optional).
>
> **remove\_duplicate** `boolean`
>
> Whether duplicate emails should be removed before processing.
>
> **first\_name\_column** `integer`
>
> 1-based index of the column containing the first name in the file (optional).
>
> **ip\_address\_column** `integer`
>
> 1-based index of the column containing IP address in the file (optional).
>
> **email\_address\_column** `integer` *required*
>
> 1-based index of the column containing the email address in the file.
>
> #### 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] Validate Email
>
> **Slug:** `ZEROBOUNCE_VALIDATE_EMAIL`
>
> Validate a single email address in real time to check deliverability and domain details before sending emails.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per email validated; unknown results are free.
>
> **Discount:** 83
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to validate.
>
> **ip\_address** `string`
>
> Optional client IP to improve geo accuracy.
>
> **credits\_info** `boolean`
>
> Include remaining credits info in the response.
>
> #### 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
