API Reference

Welcome to the Truelist API! Use the interactive documentation below to explore endpoints and integrate email verification into your applications.

Prefer an SDK? We have official libraries for JavaScript, Python, Ruby, PHP, Go, Java, and .NET, plus WordPress and n8n integrations.

Want to validate emails from Claude, Cursor, or VS Code Copilot? Use our hosted MCP server to validate emails, manage batches, and explore your account from inside any MCP-capable AI assistant — no API key required.

Getting Started

To get started, generate an API key from your account settings. You'll use the API key in an Authorization header in every request.

Base URL

All API requests should be made to:

https://api.truelist.io

Authentication

Authenticate your requests by including your API key as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limiting

Each endpoint has a rate limit. If you exceed the rate limit, you'll get a 429 error. The rate limit is 10 requests per second. This rate limit is specifically for API calls. The email validation rate limit is different and is based on your plan.

Loading API documentation...