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

# Mails.so

> Mails is an API service that provides powerful email validation capabilities to help maintain a clean and effective email list.

![Mails.so logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/mails_so.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=45c87e4527f11f823af9ef25a0a34258)

* **Category:** email
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `MAILS_SO`
* **Version:** 20261101\_00

## Tools

> [accordion] Retrieve Batch Results
>
> **Slug:** `MAILS_SO_RETRIEVE_BATCH_RESULTS`
>
> Tool to retrieve results of a bulk validation job. Use after submitting a batch and you have its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier for the batch validation job
>
> #### 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 Bulk Emails
>
> **Slug:** `MAILS_SO_VALIDATE_BULK_EMAILS`
>
> Submit 1–1000 email addresses for asynchronous bulk validation. The response contains batch job details, including an ID that can be used to check status and retrieve individual validation results later. A paid subscription is required for list validation.
>
> #### Input Parameters
>
> **emails** `array` *required*
>
> List of 1–1000 email addresses to validate
>
> #### 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 Single Email
>
> **Slug:** `MAILS_SO_VALIDATE_SINGLE_EMAIL`
>
> Tool to validate a single email address. Use when you need to check deliverability and quality details before sending an email.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to validate.
>
> #### 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
