ListClean Email Verification API

ListClean is a high accuracy email verification and list hygiene API built for businesses, SaaS products, marketers, and email platforms.

Validate email addresses in real time to reduce hard bounces, improve inbox placement, and protect sender reputation.

Why ListClean

Reduce hard bounces before sending campaigns
Improve inbox placement and sender reputation
Prevent spam traps and fake registrations
Built for high volume and production use

Key Features

Real-time verification – validate emails instantly
Disposable email detection – block temporary and fake emails
Role account detection – admin, support, info emails
Risk analysis – identify risky and low-quality addresses
Simple JSON output – easy to parse and integrate
High performance – optimized for scale

Authentication

All requests require an API key.

X-Auth-Token: YOUR_API_KEY

Get your API key from: https://app.listclean.xyz

RapidAPI automatically attaches this header for subscribed users.

Verify a Single Email

Endpoint

GET /verify

Query Parameters

email (string, required) – Email address to verify

Example Request

GET /verify?email=john.doe@example.com

Example Response

{
  "success": 1,
  "error_code": 0,
  "message": "Email verification completed!",
  "data": {
    "email": "john.doe@example.com",
    "status": "dirty",
    "remarks": "Disposable Email"
  }
}

Email Status Reference

valid – Safe to send
dirty – Disposable, role-based, or risky
invalid – Email does not exist
unknown – Mailbox could not be confirmed

Error Responses

Invalid Email

{
  "success": 0,
  "error_code": 400,
  "message": "Invalid email format"
}

Authentication Error

{
  "success": 0,
  "error_code": 401,
  "message": "Invalid or missing API key"
}

Rate Limit Exceeded

{
  "success": 0,
  "error_code": 429,
  "message": "Rate limit exceeded"
}

Common Use Cases

Clean email lists before campaigns
Validate emails during user signup
Prevent disposable or fake registrations
Improve deliverability and engagement
Protect sending reputation

Rate Limits and Usage

Rate limits depend on your RapidAPI subscription plan.

For bulk verification, higher limits, or enterprise usage, visit: https://listclean.xyz

Bulk Verification and Enterprise

ListClean supports bulk email verification and enterprise-grade workflows directly via our platform.

For custom pricing or dedicated infrastructure, contact us: https://listclean.xyz/contact

Support

Website: https://listclean.xyz
Contact: https://listclean.xyz/contact