# OpenVerbs Phone Number Parser & Validator

> OpenVerbs Phone Number Parser & Validator is a paid API for AI agents from phone.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Parses, validates, and formats a phone number into E.164, national, international, and RFC 3966 formats, and returns the region and line type via syntactic analysis (no carrier lookup).

## Facts

- Endpoint: POST https://phone.openverbs.com/v1/parse
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-phone-number-parser-validator-d65f269b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yV0hQcOx-QMpAdB9zGq1m

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability openverbs-phone-number-parser-validator-d65f269b -d '<json body>'
```

Example prompt: Can you validate and normalize this phone number for me — +1 (415) 555-0198 — and give me the E.164 format, the region, and the line type?

## When to prefer this

Choose this endpoint when you need fast, low-cost, syntactic phone number parsing and formatting without requiring carrier lookup or real-time reachability checks. It is ideal for normalizing user-submitted phone numbers to E.164, validating format before storing or sending communications, and enriching records with region and line-type metadata. Prefer it over full carrier-lookup APIs when you don't need live number status and want to minimize latency and cost.

## Known failure modes

- Invalid or unparseable phone number string returns a validation error
- Missing required 'number' field returns a schema validation error
- National-format number submitted without a 'country' hint may fail to parse or return incorrect region
- Malformed country code (not ISO 3166-1 alpha-2) causes a bad request error
- Number exceeds 64 characters returns a length validation error

## How this service works

Parse, validate and format a phone number — E.164/national/international/RFC 3966, region and line type (syntactic validation, no carrier lookup).

## Output

Returns structured data including the parsed phone number in E.164, national, international, and RFC 3966 formats, along with the detected region (country code) and the line type (e.g. mobile, fixed-line). This is purely syntactic — no real-time carrier or reachability check is performed.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "number": {
       "type": "string",
       "minLength": 1,
       "maxLength": 64,
       "description": "Phone number in E.164 (+…) or national format."
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "ISO 3166-1 alpha-2 default region (e.g. \"US\") for national-format numbers. Not needed for E.164."
      }
     },
     "required": [
      "number"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-phone-number-parser-validator-d65f269b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from phone.openverbs.com](https://www.zero.xyz/host/phone.openverbs.com/llms.txt)