# x402 AgentUtility Phone Match-Key Normalizer

> x402 AgentUtility Phone Match-Key Normalizer is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Normalizes a phone number string into a canonical E.164 match key, returning the formatted number, country code, and validity flag — no carrier lookup, fully deterministic.

## Facts

- Endpoint: POST https://x402.agentutility.ai/match-key-phone?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agentutility-phone-match-key-normalizer-1a3bf15c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gEsT_XDkcc20LyIxksTxc

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-agentutility-phone-match-key-normalizer-1a3bf15c -d '<json body>'
```

Example prompt: Normalize the phone number '(415) 555-0100' to E.164 format and tell me if it's valid and what country code it belongs to.

## When to prefer this

Use this endpoint when you need fast, deterministic phone normalization without incurring carrier lookup costs or latency. It is ideal for deduplication pipelines, CRM record linkage, and contact import validation where formatting variants of the same number need to collide to a single canonical key. Prefer it over carrier-lookup services when you don't need line type, portability, or active status — just a clean, standard E.164 string and country code.

## Known failure modes

- Invalid or unrecognizable input (e.g. random string with no valid phone digits) returns a validity flag of false with no E.164 output
- Ambiguous numbers without a country prefix may fail to resolve to a single country code
- Extremely malformed input may return an error response
- Missing or empty phone input field will result in a validation or bad-request error

## How this service works

Normalizes phone numbers into a canonical E.164 match key so formatting variants like '(415) 555-0100' and '+1 415-555-0100' collide. Strips formatting to digits and returns E.164, country code, and validity. Deterministic and instant — no carrier lookups. Use it for phone dedup, phone normalization, contact record linkage, or as an E.164 formatter.

## Output

Returns a JSON object containing the canonical E.164-formatted phone number (e.g. '+14155550100'), the country calling code (e.g. '1'), and a boolean validity flag indicating whether the input resolved to a recognizable phone number. No carrier or network data is included — this is a pure formatting and validation result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "phone"
     ],
     "properties": {
      "phone": {
       "type": "string",
       "description": "Phone number in any format."
      },
      "region": {
       "type": "string",
       "description": "Default region for numbers without a country code. Default 'US'."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "e164": {
       "type": "string"
      },
      "input": {
       "type": "string"
      },
      "is_valid": {
       "type": "boolean"
      },
      "match_key": {
       "type": "string"
      },
      "country_code": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "e164": "+14155550100",
  "input": "(415) 555-0100",
  "is_valid": true,
  "match_key": "14155550100",
  "country_code": "1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agentutility-phone-match-key-normalizer-1a3bf15c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)