> Searlo API Docs — Email Verifier
> Source: https://searlo.tech/docs#email-verify
> Full docs: https://searlo.tech/docs/full.md

# Email Verifier

Validate an email address's deliverability.

### Verify Endpoint

```
POST /email-verifier/verify
```

**Credits:** 5 per request. Rate-limited by the separate `email_verifier` tier group (see [Rate Limiting](#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": "user@example.com",
    "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 /email-verifier/history
```

**Credits:** 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) |

## Code Examples

### cURL

```bash
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": "user@example.com" }'
```

### JavaScript

```javascript
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: "user@example.com" }),
  }
);
const { data } = await res.json();
console.log(data.status); // "valid" | "invalid" | "accept_all" | "unknown" | "error"
```

### Python

```python
import os
import requests

res = requests.post(
    "https://api.searlo.tech/api/v1/email-verifier/verify",
    json={"email": "user@example.com"},
    headers={"x-api-key": os.environ["SEARLO_API_KEY"]},
)
print(res.json()["data"]["status"])
```


---
*From https://searlo.tech/docs — see full docs at https://searlo.tech/docs/full.md*