# Phone Number Check & Normalizer

> Phone Number Check & Normalizer is a paid API for AI agents from flat-rate-llm.kikoribera03.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Validates and normalizes a phone number to E.164 format, determines its country, and checks national number length — entirely offline using libphonenumber data.

## Facts

- Endpoint: POST https://flat-rate-llm.kikoribera03.workers.dev/v1/util/phone
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phone-number-check-normalizer-3101ee7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_64iBUB3vrVerYv3O2rblP

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 phone-number-check-normalizer-3101ee7b -d '<json body>'
```

Example prompt: Can you validate the phone number +14155552671 and tell me what country it's from and what the correct E.164 and national formats are?

## When to prefer this

Choose this endpoint when you need fast, offline phone number validation and normalization with no API key setup and no dependency on external services being online. Ideal for preprocessing user-submitted phone numbers before storage, detecting country of origin including shared +1 Caribbean/Canada/US disambiguation, and obtaining tel: URI or E.164 format. Not suitable if you need live carrier lookup, line type detection (mobile vs landline), or real-time number reachability checks.

## Known failure modes

- Unparseable input (garbage string not recognizable as a phone number) — returns validation failure or error
- Ambiguous number without country context where multiple formats match — best-effort country assignment
- Numbers from very recently allocated or obscure ranges may not match libphonenumber's embedded data (data freshness lag)
- Short codes or premium-rate special numbers may not validate as standard numbers

## How this service works

60 paid endpoints with no metering, no API key and no account. Each endpoint has one flat price per call, whatever the size of the request: LLM completions with automatic failover across several large models, read-only EVM tooling over Base, Ethereum, Polygon, Arbitrum and Optimism, and pure crypto utilities that touch no network.

## Output

Returns the E.164-normalized phone number, the tel: URI, the national dialling form, the resolved country (including disambiguation among the 12 shared +1 calling code countries), and a validity flag based on the country's numbering plan rules. All computed offline — no external API dependency.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "phone"
 ],
 "properties": {
  "phone": {
   "type": "string",
   "description": "The phone number, in any usual notation: +34 612 34 56 78, 0034612345678, (612) 345-678."
  },
  "country": {
   "type": "string",
   "description": "Optional ISO 3166-1 alpha-2 country, e.g. ES. Only used when the number carries no country code."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "e164": {
   "type": "string"
  },
  "phone": {
   "type": "string"
  },
  "valid": {
   "type": "boolean"
  },
  "length": {
   "type": "number"
  },
  "telUri": {
   "type": "string"
  },
  "country": {
   "type": "string"
  },
  "countryCode": {
   "type": "number"
  },
  "typesByLength": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "nationalNumber": {
   "type": "string"
  },
  "possibleLengths": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phone-number-check-normalizer-3101ee7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flat-rate-llm.kikoribera03.workers.dev](https://www.zero.xyz/host/flat-rate-llm.kikoribera03.workers.dev/llms.txt)