{"uid":"cap_PxaBu452aD4Yd4TLxevt7","slug":"blockrun-phone-number-lookup-92e8041e","name":"BlockRun Phone Number Lookup","description":"BlockRun independently tests AI agents that move money: did they pay the right party the right amount, avoid being scammed, stay within their mandate, and tell the truth afterwards. Scored from the ledger, not by a model judge.","url":"https://blockrun.ai/api/v1/phone/lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"phoneNumber":{"type":"string","description":"Phone number to look up in E.164 format."}}},"responseSchema":{"type":"object","required":["url","valid","pre_fill","sim_swap","caller_name","line_status","country_code","phone_number","identity_match","call_forwarding","national_format","sms_pumping_risk","reassigned_number","validation_errors","calling_country_code","line_type_intelligence","phone_number_quality_score"],"properties":{"url":{"type":"string"},"valid":{"type":"boolean"},"pre_fill":{"type":"null"},"sim_swap":{"type":"null"},"caller_name":{"type":"null"},"line_status":{"type":"null"},"country_code":{"type":"null"},"phone_number":{"type":"string"},"identity_match":{"type":"null"},"call_forwarding":{"type":"null"},"national_format":{"type":"string"},"sms_pumping_risk":{"type":"null"},"reassigned_number":{"type":"null"},"validation_errors":{"type":"array","items":{"type":"string"}},"calling_country_code":{"type":"null"},"line_type_intelligence":{"type":"null"},"phone_number_quality_score":{"type":"null"}}},"example":{"request":{"phoneNumber":"+1234567890"},"response":{"url":"https://lookups.twilio.com/v2/PhoneNumbers/+1234567890","valid":false,"pre_fill":null,"sim_swap":null,"caller_name":null,"line_status":null,"country_code":null,"phone_number":"+1234567890","identity_match":null,"call_forwarding":null,"national_format":"234567890","sms_pumping_risk":null,"reassigned_number":null,"validation_errors":["TOO_SHORT"],"calling_country_code":null,"line_type_intelligence":null,"phone_number_quality_score":null}},"exampleRequest":{"phoneNumber":"+1234567890"},"tags":["x402"],"displayCostAmount":"0.010000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.50","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.010000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YDBKe-1JI4qSNXWrfhkZ8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up information about a phone number provided in E.164 format, paid per-call in USDC with no API key required.","exampleAgentPrompt":"Can you look up the phone number +14155552671 and tell me what carrier it's on, what type of line it is, and what region it's registered in?","exampleUseCases":null,"resultDescription":"Returns metadata about the provided phone number, likely including carrier, line type (mobile/landline/VoIP), geographic region, and possibly owner/identity information. Response is paid per-call at $0.01 USDC settled on Base or Solana.","failureModes":["Invalid E.164 format returns validation error","Phone number not found in lookup database returns empty or null result","Insufficient USDC balance causes payment failure and 402 response","Unsupported country code may return no data","Rate limiting or network errors may return 5xx responses"],"whenToPreferThis":"Choose this endpoint when you need quick, pay-as-you-go phone number enrichment without managing API keys. Ideal for agents needing carrier, line type, or geographic metadata on a single phone number, especially when operating in a crypto-native payment context using USDC on Base or Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-09-24T21:36:16.926Z","lastSuccessfullyRanAt":"2026-07-20T15:25:53.032Z","lastHealthCheckAt":"2026-10-31T12:37:51.379Z","isFirstParty":false,"canonicalSlug":"blockrun-phone-number-lookup-92e8041e"}