{"uid":"cap_GLK6rzQY8QVCGdtMNiHKz","slug":"wtsp-dev-carrier-lookup-7fd25ecb","name":"wtsp.dev Carrier Lookup","description":"Look up any phone number on WhatsApp: registration, business profile, profile photo and carrier. AI agents pay per request in USDC on Base with x402. No sign-up, no API key.","url":"https://wtsp.dev/v1/carrier?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["phone"],"properties":{"phone":{"type":"string","description":"Phone number with its country code, e.g. +14155552671. The + is optional; spaces, dashes and a leading 00 are fine."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["phone","carrier","lineType","isMobile","country","countryName","flag","countryCallingCode","location","timezones","international","national"],"properties":{"flag":{"type":"string"},"phone":{"type":"string","description":"The number looked up, in E.164."},"carrier":{"type":"string","description":"The number's carrier. For a ported number, its original carrier."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the number."},"isMobile":{"type":["boolean","null"],"description":"Null where a country hands mobiles and landlines out of one shared range."},"lineType":{"type":"string","description":"`mobile`, `fixed line`, `fixed line or mobile`, `voip`, `toll free`…"},"location":{"type":["string","null"],"description":"Town or region the number was issued in, where published."},"national":{"type":"string","description":"The number as dialled inside its country."},"timezones":{"type":"array","items":{"type":"string"}},"countryName":{"type":"string"},"international":{"type":"string","description":"The number in international format."},"countryCallingCode":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"flag":"🇬🇧","phone":"+447400123456","carrier":"Three","country":"GB","isMobile":true,"lineType":"mobile","location":null,"national":"07400 123456","timezones":["Europe/London"],"countryName":"United Kingdom","international":"+44 7400 123456","countryCallingCode":"+44"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LKkPpQ7lYBwB4v2zOeStu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up carrier, line type, country, and location details for any phone number","exampleAgentPrompt":"Can you look up the carrier and line type for the phone number +447400123456?","exampleUseCases":[{"title":"Fraud detection pre-screening","prompt":"Before processing this new user signup, can you check what carrier and line type the phone number +14155552671 is on? I want to flag if it's a VoIP number."},{"title":"Contact data enrichment","prompt":"I have a customer phone number +33612345678 — can you tell me the carrier, whether it's mobile or landline, and what country and timezone it's in?"},{"title":"Messaging route validation","prompt":"We're about to send an SMS campaign to +5511987654321 — can you confirm whether that number is a mobile line and which carrier it's on so we can route it correctly?"}],"resultDescription":"A JSON object containing the phone number in E.164 format, carrier name (original carrier for ported numbers), ISO 3166-1 alpha-2 country code, country name, flag emoji, line type (mobile/fixed line/VoIP/toll-free etc.), isMobile boolean, location (town or region if published), timezones array, national format, international format, and country calling code.","failureModes":["Invalid or unrecognizable phone number format returns an error","Numbers from countries with no carrier data may return null fields","Ported numbers return original carrier, not current carrier","Rate limiting or payment failure via x402 protocol returns 402 Payment Required","Premium or short code numbers may not resolve cleanly"],"whenToPreferThis":"Choose this endpoint when you need lightweight, no-signup carrier and line-type intelligence for any phone number globally, billed per-request via USDC on Base. Ideal for agents that need to enrich contact data, pre-screen signups for VoIP fraud, or validate SMS routing without committing to a subscription-based telecom API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:08.658Z","isFirstParty":false,"canonicalSlug":"wtsp-dev-carrier-lookup-7fd25ecb"}