---
title: "Clean and filter an email list"
method: POST
path: "/api/v1/clean"
tags: ["List Cleaning"]
---

# Clean and filter an email list

`POST /api/v1/clean`

## Request

- Base URL: `https://verifly.email`
- URL: `https://verifly.email/api/v1/clean`
- Auth: HTTP bearer

Clean a list (up to 10000 emails) without mailbox verification. Removes duplicates, invalid formats, and optionally public-domain emails, role accounts, disposable domains, blacklisted domains, and pattern matches. Free (no credits).

## Request body

- CleanRequest
  - `emails` string[], required
  - `options` CleanOptions
    - `exclude_public_domains` boolean
    - `remove_public` boolean: Alias of exclude_public_domains.
    - `exclude_role_accounts` boolean
    - `remove_role` boolean: Alias of exclude_role_accounts.
    - `remove_disposable` boolean
    - `domain_blacklist` string[]
    - `pattern_blacklist` string[]

## Response `200`

Cleaned list and stats.

- CleanResult
  - `success` boolean, required
  - `original_count` integer, required
  - `cleaned_count` integer, required
  - `removed_count` integer, required
  - `emails` string[], required
  - `removed` SkippedEmail[], required
    - `email` string, required
    - `reason` string, required: e.g. invalid_format, duplicate, public_domain, role_account, disposable, blacklisted_domain, matched_pattern:<value>.
  - `stats` object, required
    - `duplicates` integer
    - `invalid_format` integer
    - `public_domains` integer
    - `role_accounts` integer
    - `disposable` integer
    - `blacklisted_domains` integer
    - `matched_patterns` integer

## Other responses

- `400`: Invalid request or invalid input.
- `401`: Missing or invalid API key.
- `429`: Too many requests. Includes Retry-After (seconds) and the X-RateLimit-* headers.

---

[API](https://skmtc.dev/verifly/apis/verifly-email-verification-api.md) · [All operations](https://skmtc.dev/verifly/apis/verifly-email-verification-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verifly/apis/verifly-email-verification-api/revisions/9b2787c04363?raw)