hlrlookup_people_phone_verify $0.01652 per call

Check if a phone number is live. Performs a live HLR lookup, returning number type, live status, original and current network, and porting information. Warning: a national number sent without input_format can be read as another country's number (a US 617... number as an Australian 61... number), and that lookup is still charged. (HLR Lookup · People & contact data)

For AI agents: call hlrlookup_people_phone_verify
POST https://toll402.dev/v1/p/hlrlookup.people.phone.verify
{
 "telephone_number": "447540822872",
 "save_to_cache": "PRIVATE",
 "cache_days_global": 0,
 "cache_days_private": 0
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "telephone_number": {
   "type": "string",
   "description": "International E.164 digits without the leading +, or a national number with input_format.",
   "examples": [
    "447540822872"
   ]
  },
  "input_format": {
   "type": "string",
   "description": "ISO3 country code when telephone_number is in national format, e.g. GBR. Leave unset for international input."
  },
  "output_format": {
   "type": "string",
   "description": "Format of formatted_telephone_number: E164, PLUS_E164, NATIONAL, or an ISO3 country code."
  },
  "usa_status": {
   "type": "string",
   "description": "Set YES only for +1 numbers. Without it a US number returns NOT_AVAILABLE_NETWORK_ONLY. A US mobile with YES costs two credits.",
   "default": "NO",
   "enum": [
    "YES",
    "NO"
   ]
  },
  "save_to_cache": {
   "type": "string",
   "description": "The result is cached only for this account, never shared.",
   "enum": [
    "PRIVATE"
   ]
  },
  "cache_days_global": {
   "type": "integer",
   "description": "0 never reads the shared cache, so the lookup is live.",
   "enum": [
    0
   ]
  },
  "cache_days_private": {
   "type": "integer",
   "description": "0 never reads this account's cache, so the lookup is live.",
   "enum": [
    0
   ]
  }
 },
 "additionalProperties": true,
 "required": [
  "telephone_number",
  "save_to_cache",
  "cache_days_global",
  "cache_days_private"
 ],
 "description": "Answers arrive in results[0]. live_status is LIVE, DEAD, ABSENT_SUBSCRIBER, NO_TELESERVICE_PROVISIONED, NOT_AVAILABLE_NETWORK_ONLY, NO_COVERAGE, INCONCLUSIVE or NOT_APPLICABLE; current_network_details names the serving network and is_ported says whether the number moved. Some networks give no live status (NOT_AVAILABLE_NETWORK_ONLY) but the lookup still costs a credit. Landlines and other non-mobi"
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI