Developer Tool · x402

Validate and normalize a phone number with full Google libphonenumber metadata: strict…

Validate and normalize a phone number with full Google libphonenumber metadata: strict validity against each national numbering plan, E.164 / international / national formats, country detection (correct across shared codes like +1 and +44) and line type (mobi…

by 402utils.com · discovered, not yet claimed by its owner · updated 2026-08-24

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

Validate and normalize a phone number with full Google libphonenumber metadata: strict validity against each national numbering plan, E.164 / international / national formats, country detection (correct across shared codes like +1 and +44) and line type (mobile, fixed_line, toll_free, voip…) where the plan distinguishes it. Pass ?country=FR to parse national formats. Local. ?attest=1 → Ed25519-signed.

Tags: bazaar

Use with an agent

  1. Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
  2. Inspect. Fetch /resources/5906.json for the price and payment options.
  3. Pay. Call GET https://402utils.com/v1/phone-check. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
  4. Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price
$0.002 / request
Protocol
x402 v2
Auth
No account or API key. Pay per request.
Networks
Base
Uptime
0 of the last 1 checks answered
Calls (30d)
1 · 1 unique payers (third-party data from the public x402 Bazaar)

x402 payment requirements

SchemeNetworkAssetAmountPay toTimeout
exactBase
eip155:8453
USDC$0.0020xc55A2D530b53CBaD1001e4AfD4720B7E71f9C29160s
accepts[] (raw JSON)
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xc55A2D530b53CBaD1001e4AfD4720B7E71f9C291",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "amountUsd": 0.002,
    "maxTimeoutSeconds": 60
  }
]

Schemas

Output schema (JSON Schema)
{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "phone": "+442079460958"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "country": "GB",
          "e164": "+442079460958",
          "international": "+44 20 7946 0958",
          "national": "020 7946 0958",
          "possible": true,
          "type": "fixed_line",
          "valid": true
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "description": "Query params. `phone` required; `country` helps parse national formats.",
              "properties": {
                "attest": {
                  "description": "Set to 1 for an Ed25519-signed attestation of the result (audit trail).",
                  "type": "string"
                },
                "country": {
                  "description": "ISO alpha-2 default country for national input.",
                  "type": "string"
                },
                "phone": {
                  "description": "The number, E.164 (+33612345678) or national.",
                  "type": "string"
                }
              },
              "required": [
                "phone"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "properties": {
                "attestation": {
                  "description": "Present only with ?attest=1. Ed25519 signature over the canonical result; verify against /.well-known/402utils-attestation.json.",
                  "properties": {
                    "alg": {
                      "const": "Ed25519",
                      "type": "string"
                    },
                    "payload": {
                      "properties": {
                        "endpoint": {
                          "type": "string"
                        },
                        "kid": {
                          "description": "Key id — matches a key in the .well-known document.",
                          "type": "string"
                        },
                        "resultSha256": {
                          "description": "SHA-256 of the canonical JSON of the result (attestation excluded).",
                          "type": "string"
                        },
                        "ts": {
                          "format": "date-time",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "sig": {
                      "description": "base64url Ed25519 signature over the canonical JSON of payload.",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "country": {
                  "description": "Detected ISO alpha-2; absent when undeterminable.",
                  "type": "string"
                },
                "e164": {
                  "type": "string"
                },
                "international": {
                  "type": "string"
                },
                "national": {
                  "type": "string"
                },
                "possible": {
                  "description": "Length-plausibility (looser than valid).",
                  "type": "boolean"
                },
                "type": {
                  "description": "mobile | fixed_line | fixed_line_or_mobile | toll_free | premium_rate | voip | … — absent when the plan does not distinguish.",
                  "type": "string"
                },
                "valid": {
                  "description": "Strict validity per the national numbering plan.",
                  "type": "boolean"
                }
              },
              "required": [
                "valid"
              ],
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}
Example shape — generated from the schema, not a captured live response
null

Examples

curl
curl "https://402utils.com/v1/phone-check"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://402utils.com/v1/phone-check");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}
Python
import httpx
res = httpx.get("https://402utils.com/v1/phone-check")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider
402utils.com
Endpoint
https://402utils.com/v1/phone-check
Machine-readable
/resources/5906.json