# CoCo Phone Number Validator

> CoCo Phone Number Validator is a paid API for AI agents from cocoeatsai.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-19).

Validates and parses a phone number, returning format, region, line type, and validity without owner lookup

## Facts

- Endpoint: GET https://cocoeatsai.com/area4/agent/tools/phone?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coco-phone-number-validator-48665e12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IJoBe5kZN8MByKXQOxFBa

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 coco-phone-number-validator-48665e12
```

Example prompt: Can you validate this phone number for me — +12025550123 — and tell me if it's a real format, what region it's from, and whether it's mobile or fixed line?

## When to prefer this

Use this endpoint when you need lightweight, offline phone number validation and formatting without any carrier or owner lookup. Ideal for form validation, data normalization, or pre-flight checks before sending SMS. Prefer this over full-featured carrier lookup APIs when cost, speed, and privacy matter and owner identity is not required.

## Known failure modes

- Invalid or unparseable phone number string returns valid: false
- Missing input parameter results in a 400-level error
- Numbers that are possible but unassigned may still return valid: true
- No owner information is ever returned — only structural validation

## How this service works

Zach Riehn's lab: an about-me and portfolio, a news desk, The Atelier for AI experiments, Launch Lab for XRP research, and Fracture for games.

## Output

Returns a JSON object with: validity boolean, possible boolean, E.164 format, national format, international format, region (e.g. 'US'), country code (integer), and line_type (e.g. 'fixed_line_or_mobile', 'mobile'). Note: this is format/validity only — no owner or subscriber lookup is performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "e164": "+12025550123",
  "note": "Format/validity only; no owner lookup.",
  "input": "+12025550123",
  "valid": true,
  "region": "US",
  "national": "(202) 555-0123",
  "possible": true,
  "line_type": "fixed_line_or_mobile",
  "country_code": 1,
  "international": "+1 202-555-0123"
 },
 "exampleNote": "Computed offline with demonstration inputs; time/random values are illustrative."
}
```

## More

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