Index onlineMerchant portal
Api Endpoint

Phone Number Validation

Parse and validate any phone number worldwide using libphonenumber. Returns is_valid, e164 (canonical international format e.g. '+4917612345678'), national_format, country_code (ISO alpha-2), and line_type (MOBILE/FIXED_LINE/VOIP/TOLL_FREE). Provide country_code hint (e.g. 'DE') for local numbers without country prefix.

Open interactive test console

Offering

Provider
agentsvc.io
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
General Utilities
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://agentsvc.io/api/v1/proxy/phone-validate
MIME type
application/json
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
phone-validation, phone-lookup, phone, Validation, mobile

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.0045 USDC
Atomic price: 4500 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.0045 USDC
Atomic price: 4500 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Payment option 3
0.0045 USDC
Atomic price: 4500 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 4
0.0045 USDC
Atomic price: 4500 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "4500",
    "payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "4500",
    "payTo": "5JzPS5qpEwUM1vTC9GG7uqvwJdHzbEwfoPHf2Ki977tg"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "4500",
    "payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "4500",
    "payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"
  }
]

Observed health

Status
Healthy
Latest latency
311 ms
Average latency
897 ms
HTTP status
204
Last checked
Reachability
100% over 12 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ]
    },
    "bodyType": {
      "type": "string",
      "enum": [
        "json",
        "form-data",
        "text"
      ]
    },
    "body": {
      "properties": {
        "phone": {
          "type": "string",
          "description": "Phone number to validate. Can be in any format: E.164 ('+4915123456789'), national ('015123456789'), or international ('0049 151 23456789'). Include country code (+ prefix) for best results."
        },
        "country_code": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2 country code hint for parsing national numbers without country prefix (e.g. 'DE' for Germany, 'US' for United States). Optional if number includes country code (+...)."
        }
      },
      "required": [
        "phone"
      ]
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object",
      "required": [
        "success",
        "data"
      ],
      "properties": {
        "success": {
          "type": "boolean"
        },
        "data": {
          "type": "object",
          "required": [
            "phone",
            "is_valid",
            "checks"
          ],
          "properties": {
            "phone": {
              "type": "string"
            },
            "is_valid": {
              "type": "boolean"
            },
            "e164": {
              "type": "string"
            },
            "national_format": {
              "type": "string"
            },
            "international_format": {
              "type": "string"
            },
            "country_code": {
              "type": "string"
            },
            "country_calling_code": {
              "type": "string"
            },
            "line_type": {
              "type": "string"
            },
            "checks": {
              "type": "object",
              "properties": {
                "is_possible": {
                  "type": "boolean"
                },
                "is_valid": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "type"
  ]
}