{"uid":"cap_VJBLJjTohavCQt1ky1A6f","slug":"tenjin-phone-lookup-bbdd01e8","name":"Tenjin Phone Lookup","description":"Phone intelligence for an E.164 number, in two products the caller picks between: \"name\" returns the US CNAM caller name plus the carrier data, and the cheaper \"carrier\" returns the carrier, line type, mobile network and rate-center location alone. You are charged only on a result: no name found, or an invalid number, costs nothing. Agent guide: https://tenjin.blog/llms.txt","url":"https://tenjin.blog/api/phone-lookup","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_MFvXud5Vp8woCFEqm5Klg","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 US phone number intelligence — either full CNAM caller name plus carrier data, or carrier-only details (line type, mobile network, rate-center) — with charges only on successful results.","exampleAgentPrompt":"Can you look up the caller name and carrier info for the US phone number +12025550187? Use the full 'name' product so I get the CNAM caller ID as well as the carrier and line type.","exampleUseCases":[{"title":"Identify unknown caller before callback","prompt":"I just missed a call from +13105550234 — can you tell me the CNAM caller name and what carrier that number is on so I know who it is before I call back?"},{"title":"Validate lead phone numbers before outreach","prompt":"Before I call this lead, can you check whether +18005550912 is a real US number, whether it's a mobile or landline, and which carrier it's on? Just the carrier product is fine, I don't need the caller name."},{"title":"Enrich CRM contact with carrier data","prompt":"I have a contact in my CRM with phone number +17185550456 — can you pull the carrier, line type, and rate-center location for that number so I can update their record?"}],"resultDescription":"For the 'name' product: CNAM caller name (up to 15 characters), carrier name, line type (mobile/landline/VoIP), mobile network code, and rate-center location. For the 'carrier' product: carrier name, line type, mobile network code, and rate-center location — without the CNAM name. Returns nothing (and no charge) if the number is invalid or no result is found.","failureModes":["Invalid E.164 number format — no charge, empty result returned","Number not found in CNAM database — no charge for 'name' product","Non-US number submitted — likely no result or unsupported","Missing product parameter — request may fail or default unexpectedly","Network timeout — transient failure, retry recommended"],"whenToPreferThis":"Choose this endpoint when you need to enrich a US phone number with caller ID (CNAM) or carrier metadata, especially when cost efficiency matters — you pay only for successful lookups. Prefer the 'carrier' product when you only need line type, carrier, and rate-center (cheaper). Use the 'name' product when caller identification is critical. Better than general-purpose telco APIs when you want pay-per-result pricing with no charge for misses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:54:53.437Z","isFirstParty":false}