hlrlookup_people_phone_network $0.00413 per call

Find which network serves a phone number. Mobile Number Portability lookup returning the original and current network and porting information, without a live status. (HLR Lookup · People & contact data)

For AI agents: call hlrlookup_people_phone_network
POST https://toll402.dev/v1/p/hlrlookup.people.phone.network
{
 "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."
  },
  "output_format": {
   "type": "string",
   "description": "Format of formatted_telephone_number: E164, PLUS_E164, NATIONAL, or an ISO3 country code."
  },
  "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]: current_network_details and is_ported. live_status is NOT_AVAILABLE_NETWORK_ONLY because this route does not check the line; use hlrlookup.people.phone.verify for that. For +1 numbers telephone_number_type is omitted. NO_COVERAGE, BAD_FORMAT and per-result errors are free."
}

MCP

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

All tools · OpenAPI