# Email Check (syntax + DNS) (`email.verify`)

Check an e-mail address: syntax, the domain's mail servers, disposable/role/free flags. No SMTP probe, so it cannot confirm the mailbox exists.

- **Route:** `POST /v1/run/email.verify`
- **Price:** $0.001 per request ($1.00 per 1,000) · `cost_usd` on every response
- **Source:** Cloudflare DNS over HTTPS (`dns`) · failover: no
- **Measured latency:** not enough calls measured yet
- **Heavy response:** no

## Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `email` | string | yes |  |  |

## Output (`output` in the run envelope)

| Field | Meaning |
|---|---|
| `verdict` | invalid_syntax | no_mail_server | disposable | role_account | domain_ok. |
| `mx_records` | Mail servers by priority. |
| `mailbox_checked` | Always false (no SMTP probe). |

## Example

```bash
curl -s -X POST https://getallapis.com/v1/run/email.verify \
  -H "Authorization: Bearer $GETALLAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"someone@example.com"}'
```

```python
from getallapis_client import Client
client = Client()  # reads GETALLAPIS_API_KEY
result = client.run('email.verify', {'email': 'someone@example.com'})
print(result['cost_usd'], result['output'])
```

```bash
getallapis run email.verify '{"email":"someone@example.com"}'
```

Quote first (free, validates input): `POST /v1/quote/email.verify` with the same body.
