# Listclean

Listclean is an email verification service that helps users validate and clean their email lists to improve deliverability and maintain sender reputation.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `LISTCLEAN`
- **Version:** 20260407_00

## Tools

### Create Bulk Verification List

**Slug:** `LISTCLEAN_CREATE_BULK_VERIFICATION_LIST`

Tool to create a CSV file with provided email addresses for bulk verification. Use when you need to generate a file for bulk upload through LISTCLEAN_UPLOAD_LIST.

### Delete List

**Slug:** `LISTCLEAN_DELETE_LIST`

Tool to permanently delete a single list from the account. Use when you need to remove a list that is no longer needed.

### Download List Results as CSV

**Slug:** `LISTCLEAN_DOWNLOAD_CSV`

Tool to download list results as a CSV file. Use when you need to retrieve verification results filtered by email type (clean, dirty, or unknown).

### Download List Results as JSON

**Slug:** `LISTCLEAN_DOWNLOAD_JSON`

Tool to download list results as JSON. Downloads emails filtered by type (clean, dirty, or unknown) in JSON format. Use after list verification is complete to retrieve filtered results.

### Get Account Profile

**Slug:** `LISTCLEAN_GET_ACCOUNT_PROFILE`

Tool to retrieve the authenticated account's profile. Use after obtaining a valid auth token to fetch user account data.

### Get Remaining Credits

**Slug:** `LISTCLEAN_GET_CREDITS`

Tool to retrieve remaining verification credits. Use when you need to check your available account credits before performing more email verifications.

### Get List Information

**Slug:** `LISTCLEAN_GET_LIST`

Tool to retrieve detailed information for a specific list. Returns analytics with clean/dirty breakdown, cost details, and processing status.

### Get Upload Status

**Slug:** `LISTCLEAN_GET_UPLOAD_STATUS`

Tool to retrieve the status of a specific upload. Returns upload status (inprocess, success, error), progress percentage, and chunk details. Use after initiating an upload to track its completion.

### Get Verification Logs

**Slug:** `LISTCLEAN_GET_VERIFICATION_LOGS`

Tool to retrieve logs for all single email verifications. Returns history of email verifications with status, remarks, credits deducted, and timestamps.

### List All Verification Lists

**Slug:** `LISTCLEAN_LIST_ALL`

Tool to retrieve all email verification lists. Returns all processed lists with complete analytics including clean/dirty counts, summary statistics, and cost information.

### List CSV Uploads

**Slug:** `LISTCLEAN_LIST_UPLOADS`

Tool to retrieve the list of CSV uploads. Use when you need to check upload IDs, status, and progress for all CSV file uploads in your account.

### Start Upload

**Slug:** `LISTCLEAN_START_UPLOAD`

Tool to start a CSV upload process for bulk email verification. Initializes chunked file upload and returns an upload_id for subsequent chunk uploads. Use when you need to upload large CSV files containing email addresses.

### Update Account Profile

**Slug:** `LISTCLEAN_UPDATE_PROFILE`

Tool to update account profile details. Use when you need to modify user profile information such as name, address, contact details, company information, or billing details.

### Upload Chunk

**Slug:** `LISTCLEAN_UPLOAD_CHUNK`

Tool to upload a chunk of a CSV file. Use when sending base64-encoded content with sequence number as part of chunked upload process, optionally with MD5 checksum for integrity verification.

### Verify Batch of Emails

**Slug:** `LISTCLEAN_VERIFY_BATCH`

Tool to verify a batch of email addresses (max 3000 emails). Use when you need to verify multiple emails at once and get a list_id for tracking the batch verification request.

### Verify Email Address

**Slug:** `LISTCLEAN_VERIFY_EMAIL`

Tool to verify an email's validity. Use when you need to ensure an address is deliverable and non-disposable, after collecting a user's email.