Reference
Getting started
Purelist is a REST API for real-time email verification. This guide walks you through making your first call in under five minutes.
Base URL
All endpoints are served under /api on your API host.
https://api.purelist.ioQuick start
- 1. Create an account and grab an API key from the dashboard.
- 2. Send your first verification with the snippet below.
- 3. Inspect the response and wire it into your signup flow.
POST /api/verify
curl https://api.purelist.io/api/verify \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"email":"alex@example.com"}'Response
Every verification returns a status plus a decision-ready verdict: confidence, bounce risk, a recommended action and reason codes.
{
"id": "ver_01JABXZ7K2P0",
"email": "alex@example.com",
"status": "VALID",
"score": 96,
"confidence": 0.96,
"bounce_probability": 0.04,
"action": "send",
"risk": "low",
"mailbox_confirmed": true,
"verification_method": "smtp_mailbox",
"reasons": ["smtp_verified", "mailbox_exists"]
}