Email Verifier
Validate an email address's deliverability.
Verify Endpoint#
POST
https://api.searlo.tech/api/v1/email-verifier/verifyCredits: 5 per request. Rate-limited by the separate email_verifier tier group (see Rate Limiting). Verification is also paced: when it is busy the call answers 429 VERIFIER_BUSY with a Retry-After (30 seconds by default), and is not charged.
Body#
| Field | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Email address to verify |
Response#
Responses use the standard envelope (statusCode, success, message, data).
JSON
{ "statusCode": 200, "success": true, "message": "Email verified", "data": { "email": "[email protected]", "status": "valid", "domain": "example.com", "message": "Mailbox exists", "details": { "format": true, "mailboxStatus": "...", "mailboxType": "...", "mailboxExchange": "..." }, "verifiedAt": "2026-05-20T10:30:00.000Z", "source": "searlo" }}status is one of: valid, invalid, accept_all, unknown, error.
History Endpoint#
GET
https://api.searlo.tech/api/v1/email-verifier/historyCredits: Free (0). Returns your past verifications, paginated.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | number | No | Page number (default: 1) |
limit | number | No | Results per page (1–100, default: 20) |
Examples
curl -X POST "https://api.searlo.tech/api/v1/email-verifier/verify" \ -H "x-api-key: sk_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "email": "[email protected]" }'const res = await fetch( "https://api.searlo.tech/api/v1/email-verifier/verify", { method: "POST", headers: { "x-api-key": process.env.SEARLO_API_KEY, "Content-Type": "application/json", }, body: JSON.stringify({ email: "[email protected]" }), });const { data } = await res.json();console.log(data.status); // "valid" | "invalid" | "accept_all" | "unknown" | "error"import osimport requests res = requests.post( "https://api.searlo.tech/api/v1/email-verifier/verify", json={"email": "[email protected]"}, headers={"x-api-key": os.environ["SEARLO_API_KEY"]},)print(res.json()["data"]["status"])Stuck? Write to [email protected], or check live status.