{"uid":"cap_LhyRSovxbkInQlxDp4bgV","slug":"wtsp-dev-whatsapp-full-profile-lookup-0bc07951","name":"wtsp.dev WhatsApp Full Profile 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/full?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","picUrl","picHash"],"properties":{"about":{"type":["string","null"],"description":"The \"about\" (status) text."},"picUrl":{"type":["string","null"],"description":"Permanent URL of the profile photo; null when there is none or privacy settings hide it."},"picHash":{"type":["string","null"],"description":"Content hash of the photo. Unchanged hash, unchanged photo."},"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 🍋","picUrl":"https://wtsp.dev/photos/258166877098174/tkphavoFaBWOiNjZo_B5L-uG8Bw4BjhRDNPgDs-1vp4.jpg","picHash":"tkphavoFaBWOiNjZo/B5L+uG8Bw4BjhRDNPgDs+1vp4=","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.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f0lp5OvzETkPk3WtexTB0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up a phone number's full WhatsApp profile, including registration status, account type, business details, profile photo, and linked devices","exampleAgentPrompt":"Can you look up the WhatsApp profile for +14155552671 — I want to know if it's a registered business account, see their profile photo, about text, and any business details like hours and categories?","exampleUseCases":[{"title":"Verify business WhatsApp before outreach","prompt":"Before I send a WhatsApp message to +447911123456, can you check if it's actually a registered WhatsApp Business account and pull their display name and business category?"},{"title":"Enrich CRM with WhatsApp business data","prompt":"I have a lead's phone number +5511987654321 — can you check their WhatsApp profile and tell me their business name, description, website, and hours so I can add it to our CRM?"},{"title":"Detect hosted Cloud API business accounts","prompt":"Check the WhatsApp profile for +6281234567890 and tell me if it's a hosted WhatsApp Business Platform account — I want to know if they're using the Cloud API rather than a regular phone."}],"resultDescription":"A JSON object containing: whether the number has WhatsApp, the account type (personal or business), the country code and LID identity, linked device count and whether the account is cloud-hosted, the profile photo URL and content hash, the about/status text, and for business accounts: display name, description, categories, email, website(s), address, coordinates, timezone, business hours, cart enablement, verification level, member since date, and linked Facebook page details.","failureModes":["Phone number not registered on WhatsApp — hasWhatsApp returns false with no profile data","Invalid or malformed phone number — returns 4xx error","Privacy settings hide profile photo — picUrl returns null","Privacy settings hide about text — aboutRestricted is true and about is empty","Number is personal account — business fields are absent","WhatsApp sends no device list — devices field is absent","Payment failure via x402 — request blocked before reaching WhatsApp","Rate limits or WhatsApp-side throttling — intermittent 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, single-call WhatsApp profile enrichment including business details, photo, and device signals — particularly useful for lead enrichment, pre-outreach verification, and fraud screening. It requires no API key or sign-up, making it ideal for agent workflows that pay per use in USDC via x402. Prefer this over manual WhatsApp checks or partial lookup services when you need the full picture including hosted-account detection and business hour data in one response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:22.772Z","isFirstParty":false,"canonicalSlug":"wtsp-dev-whatsapp-full-profile-lookup-0bc07951"}