# Phone Number checker API (phone-number-checker-api) — PayloadAPI LLM & Agent Reference

> Identify the carrier, line type (mobile / landline / VoIP), validity, and formatting for any phone number worldwide. Clean JSON, one fast request per number.

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

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

### Synthesized MCP Tools
- `get_api_v1_phonevalidation` (`GET /api/v1/phonevalidation`, `v1`, no required params) — GET /api/v1/phonevalidation

## Live Plans & Quota Terms
- PAYASGO ($0.00, 0 included requests, $0.000200/req usage rate)
- Free (Free: 500 requests one-time)

## Endpoints

### Version `v1` (REST)

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

#### `GET /api/v1/phonevalidation`
- **Gateway URL**: `https://gateway.payloadapi.com/phone-number-checker-api/v1/api/v1/phonevalidation`
- **Synthesized MCP Tool**: `get_api_v1_phonevalidation`
- **Parameters**:
  - `phone_number` (query, string, optional)

```bash
curl --request GET 'https://gateway.payloadapi.com/phone-number-checker-api/v1/api/v1/phonevalidation?phone_number=%2B14155552671' --header "Authorization: Bearer $PAYLOADAPI_KEY"
```