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

# MailerCheck

> MailerCheck verifies individual email addresses and email lists, reports verification results, and tracks account credit balances.

![MailerCheck logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/mailercheck.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=89af6a0148198d34b52de45fc88c94f6)

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

## Tools

> [accordion] Create Verification List
>
> **Slug:** `MAILERCHECK_CREATE_VERIFICATION_LIST`
>
> Create a MailerCheck verification list by ingesting a name and email-address array. Creating a one-address list did not reduce the account credit balance during live probing. This action does not invoke the separate, credit-consuming Start List Verification operation.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the new verification list.
>
> **emails** `array` *required*
>
> One or more valid email addresses to ingest. MailerCheck does not document a maximum list size or how duplicate addresses are handled.
>
> #### 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 Verification List
>
> **Slug:** `MAILERCHECK_DELETE_VERIFICATION_LIST`
>
> Permanently and irreversibly delete a MailerCheck verification list by ID. Use only when the caller explicitly intends to remove the list.
>
> #### Input Parameters
>
> **list\_id** `integer` *required*
>
> ID of the verification list to permanently delete. Verify the ID before calling because deletion is irreversible.
>
> #### 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:** `MAILERCHECK_GET_CREDIT_BALANCE`
>
> Return the current MailerCheck verification-credit balance. Use this before VERIFY\_EMAIL or START\_LIST\_VERIFICATION when cost matters.
>
> #### 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 Current Account
>
> **Slug:** `MAILERCHECK_GET_CURRENT_ACCOUNT`
>
> Return the connected MailerCheck user and account identity. Use this to confirm which user and account the API token represents.
>
> #### 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 Verification List
>
> **Slug:** `MAILERCHECK_GET_VERIFICATION_LIST`
>
> Return one verification list, including its status, item count, verification timing, and aggregate result statistics.
>
> #### Input Parameters
>
> **list\_id** `integer` *required*
>
> Verification-list ID returned by CREATE\_VERIFICATION\_LIST or LIST\_VERIFICATION\_LISTS.
>
> #### 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 Verification Lists
>
> **Slug:** `MAILERCHECK_LIST_VERIFICATION_LISTS`
>
> Return one page of verification lists for the connected MailerCheck account, with an opaque cursor when another provider-controlled page exists.
>
> #### Input Parameters
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. Pass it unchanged to fetch the next page, or omit it for the first page.
>
> #### 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 Verification Results
>
> **Slug:** `MAILERCHECK_LIST_VERIFICATION_RESULTS`
>
> Return one page of email-level results for a verification list, optionally filtered by classification. The success envelope and pagination behavior are based on MailerCheck documentation and were not live-verified because producing results requires a credit-consuming list verification.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Requested results per page. MailerCheck documents a default of 100 but does not document a maximum, and live behavior was not verified.
>
> **result** `string ("valid" | "catch_all" | "mailbox_full" | "role" | "unknown" | "syntax_error" | "typo" | "mailbox_not_found" | "disposable" | "blocked" | "error")`
>
> Optional exact verification classification to return.
>
> **list\_id** `integer` *required*
>
> ID of a list whose verification has been started.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. Pass it unchanged to fetch the next page; it preserves the list ID, classification filter, and limit.
>
> #### 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] Start List Verification
>
> **Slug:** `MAILERCHECK_START_LIST_VERIFICATION`
>
> Irreversibly start verification of every address in a MailerCheck list. A successful call spends one verification credit per address. Before calling, use GET\_VERIFICATION\_LIST to inspect the list count and GET\_CREDIT\_BALANCE to confirm the current credit\_balance. This endpoint was not live-executed because the authorized verification-credit budget was exhausted.
>
> #### Input Parameters
>
> **list\_id** `integer` *required*
>
> Verification-list ID to start. This irreversible operation spends one MailerCheck verification credit per address in the list. Check the list count and current account credit\_balance before calling.
>
> #### 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:** `MAILERCHECK_VERIFY_EMAIL`
>
> Consumes exactly one MailerCheck verification credit on every successful call. Synchronously verify one email address and return its classification; check GET\_CREDIT\_BALANCE first if cost matters.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to verify. Every successful request spends exactly one MailerCheck verification credit.
>
> #### 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
