# WhatsApp Validation (whatsapp-validation) — PayloadAPI LLM & Agent Reference

> Real-time WhatsApp number validation API. Checks phone number validity, line type, carrier, location, and WhatsApp registration status.

## Quick Facts
- **Catalog Page**: https://payloadapi.com/apis/whatsapp-validation
- **LLM Context URL**: https://payloadapi.com/apis/whatsapp-validation/llms.txt
- **Gateway Origin**: `https://gateway.payloadapi.com`
- **Trust Score**: 72/100
- **Published Versions**: `v1` (REST)
- **30-Day Availability**: 100%
- **P95 Latency**: 6471 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 `whatsapp-validation` 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/whatsapp-validation/v1/mcp`

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

### Synthesized MCP Tools
- `get_wavalidation` (`GET /wavalidation`, `v1`, required: phone_number) — WhatsApp Validation

## Live Plans & Quota Terms
- Pay-As-You-Go ($0.00, 0 included requests, $0.003000/req usage rate)
- Free (Free: 20 requests one-time)
- Starter ($9.99/month, 5,000 included requests, $0.000000/req usage rate)
- Business ($29.99/month, 30,000 included requests, $0.000000/req usage rate)

## Endpoints

### Version `v1` (REST)

- **Gateway Base Path**: `https://gateway.payloadapi.com/whatsapp-validation/v1`
- **MCP Bridge Endpoint**: `POST https://gateway.payloadapi.com/whatsapp-validation/v1/mcp`

#### `GET /wavalidation`
**WhatsApp Validation**
Validates a phone number and checks if it is registered on WhatsApp, including business account detection.
- **Gateway URL**: `https://gateway.payloadapi.com/whatsapp-validation/v1/wavalidation`
- **Synthesized MCP Tool**: `get_wavalidation`
- **Parameters**:
  - `phone_number` (query, string, required) — The phone number to validate in international E.164 format with country code (e.g., +14155552671 or +919038659595).

```bash
curl --request GET 'https://gateway.payloadapi.com/whatsapp-validation/v1/wavalidation?phone_number=%2B14155552671' --header "Authorization: Bearer $PAYLOADAPI_KEY"
```