{"uid":"cap_HOD9BN3vbikxOBVfchAII","slug":"wtsp-dev-whatsapp-phone-lookup-0cff1ddb","name":"wtsp.dev WhatsApp Phone 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/profile?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","oneOf":[{"type":"object","required":["phone","hasWhatsApp","accountType","identity","profile","business","checkedAt"],"properties":{"phone":{"type":"string","description":"The number looked up, in E.164."},"devices":{"type":"object","required":["count","hosted"],"properties":{"count":{"type":"number","description":"Linked devices including the phone itself, so 1 means phone only."},"hosted":{"type":"boolean","description":"Served by the WhatsApp Business Platform (Cloud API) rather than a phone: a strong real-business signal."}},"description":"Absent on the rare occasion WhatsApp sends no device list."},"profile":{"type":"object","required":["about","aboutRestricted"],"properties":{"about":{"type":["string","null"],"description":"The \"about\" (status) text."},"aboutRestricted":{"type":"boolean","description":"True when an about text exists but privacy settings hide it, so `about` is empty."}}},"business":{"anyOf":[{"type":"object","required":["displayName","description","categories","email","websites","address","latitude","longitude","timezone","hours","memberSince","memberSinceTs","businessType","verifiedLevel","cartEnabled","commerceExperience","automatedType","linkedFacebookPage"],"properties":{"email":{"type":["string","null"]},"hours":{"type":"array","items":{"type":"object","required":["day","mode","openTime","closeTime"],"properties":{"day":{"type":"string","description":"Day of week, e.g. `mon`."},"mode":{"type":"string","description":"`specific_hours`, `open_24h` or `appointment_only` (times are null then)."},"openTime":{"type":["string","null"],"description":"Opening time, HH:MM."},"closeTime":{"type":["string","null"],"description":"Closing time, HH:MM."}}},"description":"Opening hours per day."},"address":{"type":["string","null"]},"latitude":{"type":["number","null"]},"timezone":{"type":["string","null"],"description":"IANA zone the opening hours are in."},"websites":{"type":"array","items":{"type":"string"}},"longitude":{"type":["number","null"]},"categories":{"type":"array","items":{"type":"string"},"description":"Every category the business picked; often more than one."},"cartEnabled":{"type":"boolean","description":"Whether the account sells through a WhatsApp cart."},"description":{"type":["string","null"]},"displayName":{"type":["string","null"],"description":"Public business name. Personal accounts publish no name at all."},"memberSince":{"type":["string","null"],"description":"When the business joined, as WhatsApp words it: \"Joined in January, 2026\"."},"businessType":{"type":["string","null"],"description":"`smb` for a small business, or an enterprise tier."},"automatedType":{"type":["string","null"],"description":"Set when WhatsApp flags the account as automated (a bot)."},"memberSinceTs":{"type":["number","null"],"description":"The same moment as a unix timestamp (seconds)."},"verifiedLevel":{"type":["string","null"],"description":"Meta verification tier."},"commerceExperience":{"type":["string","null"]},"linkedFacebookPage":{"anyOf":[{"type":"object","required":["id","name","likes"],"properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"likes":{"type":["number","null"]}}},{"type":"null"}],"description":"Linked Facebook page and its follower count."}}},{"type":"null"}],"description":"Business profile; null for personal accounts."},"identity":{"type":"object","required":["countryCode","lid"],"properties":{"lid":{"type":["string","null"],"description":"WhatsApp's internal account id. Numbers that share one account share it."},"countryCode":{"type":["string","null"],"description":"Country WhatsApp reports for the account (ISO 3166-1 alpha-2), not one guessed from the prefix."}}},"checkedAt":{"type":"string","description":"When this answer was fetched from WhatsApp (ISO 8601)."},"accountType":{"enum":["business","personal"],"type":"string","description":"`business` when WhatsApp published a business profile."},"hasWhatsApp":{"type":"boolean","const":true,"description":"The number is a registered WhatsApp account."}}},{"type":"object","required":["phone","hasWhatsApp","checkedAt"],"properties":{"phone":{"type":"string","description":"The number looked up, in E.164."},"checkedAt":{"type":"string","description":"When this answer was fetched from WhatsApp (ISO 8601)."},"hasWhatsApp":{"type":"boolean","const":false,"description":"The number is not on WhatsApp: a definitive answer, not a failure."}}}]}}}}},"responseSchema":{"type":"json","example":{"phone":"+14155552671","devices":{"count":2,"hosted":false},"profile":{"about":"Fresh groceries, delivered daily 🍋","aboutRestricted":false},"business":{"email":"hello@freshmarket.example","hours":[{"day":"mon","mode":"specific_hours","openTime":"08:00","closeTime":"20:00"},{"day":"sat","mode":"specific_hours","openTime":"09:00","closeTime":"18:00"},{"day":"sun","mode":"appointment_only","openTime":null,"closeTime":null}],"address":"123 Market St, San Francisco, CA 94103","latitude":37.7749,"timezone":"America/Los_Angeles","websites":["https://freshmarket.example"],"longitude":-122.4194,"categories":["Grocery Store","Food delivery"],"cartEnabled":true,"description":"Neighbourhood grocery with same-day delivery across San Francisco.","displayName":"Fresh Market SF","memberSince":"Joined in March, 2021","businessType":"smb","automatedType":"unknown","memberSinceTs":1615420800,"verifiedLevel":"unknown","commerceExperience":"none","linkedFacebookPage":{"id":"100064523310987","name":"Fresh Market SF","likes":1840}},"identity":{"lid":"258166877098174@lid","countryCode":"US"},"checkedAt":"2026-10-09T18:24:03.000Z","accountType":"business","hasWhatsApp":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CU2t_n07Qdc95cyVbhDU7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","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 on WhatsApp to return registration status, account type, business profile, device info, and carrier details.","exampleAgentPrompt":"Can you check if +14155552671 is on WhatsApp and pull up their full business profile — I want to know their hours, categories, and whether they're using the WhatsApp Business API?","exampleUseCases":[{"title":"Verify customer WhatsApp before outreach","prompt":"Before we send that campaign, check if the number +447911123456 is actually registered on WhatsApp and whether it's a personal or business account."},{"title":"Enrich business lead with WhatsApp details","prompt":"I have this business phone number +5511999887766 — can you look it up on WhatsApp and get me their business name, description, hours, and website?"},{"title":"Detect WhatsApp Business API accounts","prompt":"Is +12125550199 a real WhatsApp Business API hosted number, or just a regular phone? I need to know if they're running automated messaging."}],"resultDescription":"A JSON object containing: E.164 formatted phone number, hasWhatsApp boolean, accountType (personal or business), identity (LID and country code), profile about text and privacy flag, optional business object with display name, description, categories, email, websites, address, geo-coordinates, timezone, business hours, member since date, Facebook page link, commerce settings, verification level, and device info (count and whether hosted on WhatsApp Business Platform). Returns a minimal object with hasWhatsApp: false if number is not registered.","failureModes":["Invalid phone number format returns a 400 error","Number not registered on WhatsApp returns hasWhatsApp: false with no profile data","Rate limits or WhatsApp availability issues may return 5xx errors","Payment failure via x402 results in 402 Payment Required","Business profile fields may be absent if privacy settings restrict them","Device count may be absent if WhatsApp does not return a device list"],"whenToPreferThis":"Choose this endpoint when you need real-time WhatsApp registration and business profile data for a specific phone number without managing API keys or subscriptions. It is ideal for contact enrichment pipelines, lead qualification, fraud detection, or pre-outreach verification where you want to confirm WhatsApp presence and retrieve structured business metadata in a single pay-per-use call. Prefer it over manual lookups or scraping when operating at scale with per-call billing via USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:43:08.107Z","isFirstParty":false,"canonicalSlug":"wtsp-dev-whatsapp-phone-lookup-0cff1ddb"}