# x402.forgemesh.io Phone Number Parser

> x402.forgemesh.io Phone Number Parser is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Validates a phone number and returns its E.164 canonical form, country, national/international formats, and line type (mobile/landline)

## Facts

- Endpoint: POST https://x402.forgemesh.io/parse-phone-number
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-forgemesh-io-phone-number-parser-9cf25895
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5QLRQ0mBpkKxc6okMqA48

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 x402-forgemesh-io-phone-number-parser-9cf25895 -d '<json body>'
```

Example prompt: Can you validate this phone number from our signup form — '(212) 555-0147' — treat it as a US number and tell me its E.164 format, whether it's mobile or landline, and if it's actually valid?

## When to prefer this

Use this endpoint when you need to parse, normalize, or validate phone numbers from messy human input — especially for lead cleaning, CRM deduplication, signup validation, or dialing workflows where E.164 format and line-type classification are required. Prefer this over regex-only solutions when you need authoritative country detection and format normalization.

## Known failure modes

- Unparseable number string returns an error or invalid flag
- Ambiguous national format without a country hint may misidentify country
- Line type may be indeterminate for some regions or VoIP numbers
- Non-numeric garbage input may fail to parse
- Country code hint not recognized returns a validation error

## How this service works

Phone number parsing API: validate any phone number and get its country, E.164 canonical form, national and international formats, and line type (mobile/landline where determinable). Handles messy human input with a default-country hint. For lead cleaning, signup validation, CRM dedup, and dialing agents. Nothing stored.

## Output

Returns the validated phone number in E.164 canonical form, the detected country, national and international display formats, and the line type (mobile or landline where determinable), plus a validity indicator.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "number": {
   "type": "string"
  },
  "country": {
   "type": "string",
   "description": "2-letter default country for national input, default US"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "e164": "+17135550142",
  "valid": true,
  "country": "US",
  "international": "+1 713 555 0142"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-forgemesh-io-phone-number-parser-9cf25895/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)