# Email Verification API (email-verification-api) — PayloadAPI LLM & Agent Reference

> Real-time email verification and deliverability API by ProWebLook. Validates email syntax, queries receiving mail exchangers, and returns detailed deliverability signals—including mailbox existence, deliverable/undeliverable verdicts, catch-all server detection, and reason codes.

## Quick Facts
- **Catalog Page**: https://payloadapi.com/apis/email-verification-api
- **LLM Context URL**: https://payloadapi.com/apis/email-verification-api/llms.txt
- **Gateway Origin**: `https://gateway.payloadapi.com`
- **Trust Score**: 75/100
- **Published Versions**: `v1` (REST)
- **30-Day Availability**: 100%
- **P95 Latency**: 15200 ms

## Authentication
All requests route through the PayloadAPI Edge Gateway and authenticate with a buyer application key in the `Authorization` header. Never hardcode keys; export `$PAYLOADAPI_KEY` in your environment:

```bash
export PAYLOADAPI_KEY="payload_live_<app_public_id>.<secret>"
```

Required request header:
```http
Authorization: Bearer $PAYLOADAPI_KEY
```

## Edge REST-to-MCP Bridge (Model Context Protocol)
Every REST version of `email-verification-api` is automatically exposed as a JSON-RPC 2.0 MCP server at the edge. Discovery methods (`initialize`, `notifications/initialized`, `ping`, `tools/list`) are **quota-free**; `tools/call` executions are metered against your active plan.

- **MCP Server Endpoint**: `POST https://gateway.payloadapi.com/email-verification-api/v1/mcp`

### One-Click MCP Configuration (`.cursor/mcp.json` / `claude_desktop_config.json` / Antigravity)
```json
{
  "mcpServers": {
    "payloadapi-email-verification-api": {
      "url": "https://gateway.payloadapi.com/email-verification-api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PAYLOADAPI_KEY}"
      }
    }
  }
}
```

### Synthesized MCP Tools
- `get_checkemail` (`GET /checkemail`, `v1`, required: email) — Verify Email Address (Alternative Endpoint)
- `get_emailvalidation` (`GET /emailvalidation`, `v1`, required: email) — Email Verification
- `post_emailvalidation` (`POST /emailvalidation`, `v1`, required: email) — Email Verification (POST)

## Live Plans & Quota Terms
- Pay-As-You-Go ($0.00, 0 included requests, $0.002000/req usage rate)
- Free (Free: 25 requests / month)

## Endpoints

### Version `v1` (REST)

- **Gateway Base Path**: `https://gateway.payloadapi.com/email-verification-api/v1`
- **MCP Bridge Endpoint**: `POST https://gateway.payloadapi.com/email-verification-api/v1/mcp`

#### `GET /emailvalidation`
**Email Verification**
Verify email syntax and mailbox deliverability in real time without sending an email. Validates email syntax, queries receiving mail exchangers, and returns detailed deliverability signals—including mailbox existence, deliverable/undeliverable verdicts, catch-all server detection, and reason codes.
- **Gateway URL**: `https://gateway.payloadapi.com/email-verification-api/v1/emailvalidation`
- **Synthesized MCP Tool**: `get_emailvalidation`
- **Parameters**:
  - `email` (query, string, required) — The email address to verify (e.g. user@example.com).

```bash
curl --request GET 'https://gateway.payloadapi.com/email-verification-api/v1/emailvalidation?email=user%40example.com' --header "Authorization: Bearer $PAYLOADAPI_KEY"
```

#### `POST /emailvalidation`
**Email Verification (POST)**
Verify email syntax and mailbox deliverability in real time via POST.
- **Gateway URL**: `https://gateway.payloadapi.com/email-verification-api/v1/emailvalidation`
- **Synthesized MCP Tool**: `post_emailvalidation`
- **Parameters**:
  - `email` (query, string, required) — The email address to verify.

```bash
curl --request POST 'https://gateway.payloadapi.com/email-verification-api/v1/emailvalidation?email=user%40example.com' --header "Authorization: Bearer $PAYLOADAPI_KEY" --header 'Content-Type: application/json' --data-raw ''
```

#### `GET /checkemail`
**Verify Email Address (Alternative Endpoint)**
Alternative endpoint path for email verification.
- **Gateway URL**: `https://gateway.payloadapi.com/email-verification-api/v1/checkemail`
- **Synthesized MCP Tool**: `get_checkemail`
- **Parameters**:
  - `email` (query, string, required) — The email address to verify.

```bash
curl --request GET 'https://gateway.payloadapi.com/email-verification-api/v1/checkemail?email=user%40example.com' --header "Authorization: Bearer $PAYLOADAPI_KEY"
```