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

# TrueList

> TrueList validates email addresses, manages batch validation jobs, and retrieves validation history.

![TrueList logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/true_list.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=47a4282d3c7cd4c6f630f18c94f39544)

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

## Tools

> [accordion] Create Batch
>
> **Slug:** `TRUE_LIST_CREATE_BATCH`
>
> Create an asynchronous TrueList batch email-validation job from tabular rows. A successful call consumes validation credits, so use ESTIMATE\_BATCH first when cost or row counts are uncertain.
>
> #### Input Parameters
>
> **rows** `array` *required*
>
> Tabular rows for the batch, with a header row first and at least one data row containing an email value. A successful request consumes validation credits.
>
> **filename** `string`
>
> Name shown for the uploaded data and batch.
>
> **webhook\_url** `string`
>
> HTTPS callback URL that TrueList should POST the batch ID to when processing completes.
>
> **validation\_strategy** `string ("accurate" | "fast")`
>
> Batch validation strategy. fast skips retries; accurate performs the standard validation flow.
>
> #### 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
>
> **Slug:** `TRUE_LIST_DELETE_BATCH`
>
> Permanently delete one completed TrueList batch and its validation results. This destructive operation cannot be undone, and TrueList rejects deletion when the batch is missing or has not completed.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> UUID of the completed batch to permanently delete. This removes the batch and its validation results and cannot be undone.
>
> #### 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] Estimate Batch
>
> **Slug:** `TRUE_LIST_ESTIMATE_BATCH`
>
> Estimate email count, duplicates, and processing time for tabular batch data without creating a batch or consuming batch-validation credits.
>
> #### Input Parameters
>
> **rows** `array` *required*
>
> Tabular rows to estimate, with a header row first and one email value in each data 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] Get Account
>
> **Slug:** `TRUE_LIST_GET_ACCOUNT`
>
> Return the connected TrueList user identity, account name, and payment plan without exposing API tokens or other account users.
>
> #### 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
>
> **Slug:** `TRUE_LIST_GET_BATCH`
>
> Get one TrueList batch-validation job by UUID, including progress counts and completed result download URLs. The provider may return nonterminal states including pending, pending\_processing, processing, and finalizing.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> UUID of the batch to retrieve, returned by create or list batches.
>
> #### 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 Batches
>
> **Slug:** `TRUE_LIST_LIST_BATCHES`
>
> List all batch-validation jobs in the connected TrueList account, including their current processing state, progress counts, and available result download URLs. TrueList returns the complete list without documented pagination.
>
> #### 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 Validation History
>
> **Slug:** `TRUE_LIST_LIST_VALIDATION_HISTORY`
>
> Return one page of previously validated email results, optionally filtered by batch, address, state, or sub-state.
>
> #### Input Parameters
>
> **email** `string`
>
> Return history for this exact address as TrueList recorded it, including addresses it marked failed\_syntax\_check.
>
> **batch\_id** `string`
>
> Return only validation results belonging to this batch UUID.
>
> **page\_size** `integer`
>
> Maximum results to return in this page (1-100).
>
> **email\_state** `string ("ok" | "risky" | "invalid" | "unknown")`
>
> Filter by TrueList's history-filter state. Returned result states may use provider variants such as email\_invalid.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by the previous call; omit for the first page.
>
> **email\_sub\_state** `string ("email_ok" | "accept_all" | "is_disposable" | "is_role" | "failed_mx_check" | "failed_smtp_check" | "failed_no_mailbox" | "failed_greylisted" | "failed_syntax_check")`
>
> Filter by the specific validation outcome reason.
>
> #### 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:** `TRUE_LIST_VALIDATE_EMAIL`
>
> Validate one email address synchronously, consume validation capacity, and add the result to TrueList validation history.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Single 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
