# Email Validation API
> Verify email addresses without sending anything: RFC syntax validation, live MX-record lookup, disposable/throwaway detection (5,500+ domain blocklist), role-account and free-provider flags, "did you mean" typo suggestion, and a 0–100 deliverability score.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/email-api/..."
```

## Pricing
- **Free** (Free) — 1,000 calls/Mo, 2 req/s
- **Basic** ($15/Mo) — 25,000 calls/Mo, 10 req/s
- **Pro** ($49/Mo) — 150,000 calls/Mo, 20 req/s
- **Mega** ($129/Mo) — 600,000 calls/Mo, 40 req/s

## Endpoints

### Validation

#### `GET /v1/disposable` — Check if a domain is disposable/free

**Parameters:**
- `domain` (query, required, string) — Domain (or pass email=) Example: `mailinator.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/email-api/v1/disposable?domain=mailinator.com"
```

**Response:**
```json
{
    "data": {
        "domain": "mailinator.com",
        "is_free": false,
        "is_disposable": true
    },
    "meta": {
        "timestamp": "2026-05-29T22:12:04.791Z",
        "request_id": "a2c2a696-f281-4db0-bab3-98a8db03a738"
    },
    "status": "ok",
    "message": "Domain checked successfully",
    "success": true
}
```

#### `GET /v1/verify` — Verify an email address

**Parameters:**
- `email` (query, required, string) — Email address to verify Example: `jane.doe@gmail.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/email-api/v1/verify?email=jane.doe%40gmail.com"
```

**Response:**
```json
{
    "data": {
        "email": "jane.doe@gmail.com",
        "score": 100,
        "domain": "gmail.com",
        "reason": "deliverable",
        "status": "deliverable",
        "is_free": true,
        "is_role": false,
        "mx_found": true,
        "local_part": "jane.doe",
        "mx_records": [
            {
                "exchange": "gmail-smtp-in.l.google.com",
                "priority": 5
            },
            {
                "exchange": "alt1.gmail-smtp-in.l.google.com",
                "priority": 10
            },
            {
                "exchange": "alt2.gmail-smtp-in.l.google.com",
                "priority": 20
            },
            {
                "exchange": "alt3.gmail-smtp-in.l.google.com",
                "priority": 30
            },
            {
                "exchange": "alt4.gmail-smtp-in.l.google.com",
                "priority": 40
            }
        ],
        "normalized": "jane.doe@gmail.com",
        "did_you_mean": null,
        "valid_syntax": true,
        "is_disposable": false
    },
    "meta": {
        "timestamp": "2026-05-29T22:12:04.866Z",
        "request_id": "b92c5dc9-56eb-48b1-9a53-eac4770d5523"
    },
    "status": "ok",
    "message": "Email verified successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/email-api
OpenAPI spec: https://www.oanor.com/api/email-api/openapi.json