# Phone Number Tools

Parse, validate and format phone numbers worldwide from bundled libphonenumber metadata, with no dependency.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://phone-tools.x402tookit.com/openapi.json
- x402 manifest: https://phone-tools.x402tookit.com/.well-known/x402
- Catalog (free): https://phone-tools.x402tookit.com/catalog
- Health (free): https://phone-tools.x402tookit.com/health
- Uptime (free): https://phone-tools.x402tookit.com/uptime

## Endpoints (8)

### GET /country-calling-codes — $0.02
Look up which regions use a country calling code (+44, +1) or a region's code, dialing prefixes and national prefix.
Params: code?: string, region?: string
Example: https://phone-tools.x402tookit.com/country-calling-codes?code=%2B44

### GET /phone-compare — $0.02
Compare two phone number strings: exact match, same national number, short match or different, with an optional region.
Params: a: string, b: string, default_region?: string
Example: https://phone-tools.x402tookit.com/phone-compare?a=%2B1+201-555-0123&b=%28201%29+555-0123&default_region=US

### GET /phone-example — $0.02
Example phone numbers per region and type (fixed line, mobile, toll free, premium) taken from libphonenumber metadata.
Params: region: string, type?: string
Example: https://phone-tools.x402tookit.com/phone-example?region=DE&type=mobile

### GET /phone-format — $0.02
Format a phone number as E.164, international, national and RFC3966 tel: URI using the region's numbering-plan rules.
Params: number: string, default_region?: string, format?: string
Example: https://phone-tools.x402tookit.com/phone-format?number=%2B12015550123

### GET /phone-parse — $0.02
Parse a phone number (E.164 or national) into country code, national number, region, number type and validity.
Params: number: string, default_region?: string
Example: https://phone-tools.x402tookit.com/phone-parse?number=%28201%29+555-0123&default_region=US

### GET /phone-possible-lengths — $0.02
Possible national phone number lengths for a region overall and per type, with local-only lengths and the E.164 total.
Params: region: string, type?: string
Example: https://phone-tools.x402tookit.com/phone-possible-lengths?region=JP

### GET /phone-region-guess — $0.02
Guess the region from an international +prefix or partial number: calling code, candidate regions and how certain it is.
Params: prefix: string
Example: https://phone-tools.x402tookit.com/phone-region-guess?prefix=%2B1649

### GET /phone-validate — $0.02
Validate a phone number against the numbering plan: possible length, valid pattern, optionally for one region. Syntax only.
Params: number: string, default_region?: string, for_region?: string
Example: https://phone-tools.x402tookit.com/phone-validate?number=%2B442012345678&for_region=GB

## Terms

Syntax and numbering-plan checks from a bundled libphonenumber metadata snapshot. A valid-looking number is not proof that it is assigned, reachable or belongs to anyone. Not a carrier lookup.