{"uid":"cap_JfeOfe0ZdRBo3V46JfW13","slug":"tenjin-phone-lookup-867638c9","name":"Tenjin Phone Lookup","description":"Tenjin is the tool router for coding agents. Install it once, and it hands your agent the right tool when it helps, paid from one wallet.","url":"https://tenjin.sh/api/phone-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"product":{"enum":["name","carrier"],"type":"string","default":"name","description":"Which product to buy. \"name\" (the default) returns the CNAM caller name plus the carrier data and is charged only when a name is found. \"carrier\" is cheaper, omits the name entirely, and is charged only when the number is valid. Caller names exist for US numbers only, so a non-US number should buy \"carrier\"."},"phoneNumber":{"type":"string","pattern":"^\\+[1-9][0-9]{7,14}$","description":"The phone number to identify, in E.164 form: a leading + followed by 8 to 15 digits (for example \"+13129457420\")."}}},"responseSchema":{"type":"json","example":{"valid":true,"carrier":"the carrier that holds the number","product":"name","lineType":"mobile","location":{"city":"the rate-center city","state":"the rate-center state"},"callerName":"the name on record for the number you asked about","countryCode":"US","phoneNumber":"+10000000000","mobileNetwork":{"mcc":"000","mnc":"000"},"portedCarrier":"the underlying carrier when the number has been ported","nationalFormat":"(000) 000-0000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8f6dFs5VtAwWDP8vsX5ff","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up a phone number to return the caller name (CNAM), carrier, line type, location, and porting information in E.164 format.","exampleAgentPrompt":"Can you look up the caller name and carrier for the phone number +13129457420?","exampleUseCases":[{"title":"Spam call screening for a user","prompt":"I just got a call from +14155552671 — can you look up the caller name and carrier to tell me if it's a legitimate business or likely spam?"},{"title":"Carrier validation before SMS campaign","prompt":"Before we send marketing texts, check the carrier and line type for +447911123456 — it's a UK number so just get the carrier info without the name."},{"title":"Ported number carrier detection","prompt":"Our records show a customer's number as +12025550184 — can you find out who the current carrier is and whether it's been ported away from the original provider?"}],"resultDescription":"Returns a JSON object with: a validity flag, the carrier name, ported carrier (if applicable), line type (mobile/landline/etc.), city and state location based on rate center, country code, national formatted number, mobile network MCC and MNC codes, and (for the 'name' product on US numbers) the CNAM caller name on record.","failureModes":["Number not in E.164 format returns a validation error","Non-US number with 'name' product returns no caller name (should use 'carrier' product instead)","Invalid or unassigned number returns valid:false with no carrier data","Payment failure via x402 prevents the lookup from completing","Rate limits or upstream carrier data unavailability may cause timeouts"],"whenToPreferThis":"Choose this endpoint when you need real-time phone number intelligence including caller name (CNAM), carrier, line type, and porting status, especially within an agent workflow that already uses x402 micropayment infrastructure. It is particularly well-suited when you need CNAM data for US numbers or carrier validation for international numbers, and when per-call pay-as-you-go pricing ($1 USDC) is preferable to a subscription. Use the 'carrier' product for non-US numbers or when caller name is not needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:30:25.087Z","isFirstParty":false,"canonicalSlug":"tenjin-phone-lookup-867638c9"}