{"slug":"wtsp-dev-v1-profile-779d83","title":"Whether a number is on WhatsApp and, if so","host":"wtsp.dev","method":"GET","resource":"https://wtsp.dev/v1/profile","category":"image","description":"Whether a number is on WhatsApp and, if so: personal or business account, about text, country, linked devices and whether it runs on the Cloud API. Businesses add their public profile: name, description, categories, email, websites, address, coordinates, hours, join date and Facebook page. No photo;","price_listed":0.006,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"phone":"+14155552671"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"phone":{"description":"Phone number with its country code, e.g. +14155552671. The + is optional; spaces, dashes and a leading 00 are fine.","type":"string"}},"required":["phone"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"oneOf":[{"properties":{"accountType":{"description":"`business` when WhatsApp published a business profile.","enum":["business","personal"],"type":"string"},"business":{"anyOf":[{"properties":{"address":{"type":["string","null"]},"automatedType":{"description":"Set when WhatsApp flags the account as automated (a bot).","type":["string","null"]},"businessType":{"description":"`smb` for a small business, or an enterprise tier.","type":["string","null"]},"cartEnabled":{"description":"Whether the account sells through a WhatsApp cart.","type":"boolean"},"categories":{"description":"Every category the business picked; often more than one.","items":{"type":"string"},"type":"array"},"commerceExperience":{"type":["string","null"]},"description":{"type":["string","null"]},"displayName":{"description":"Public business name. Personal accounts publish no name at all.","type":["string","null"]},"email":{"type":["string","null"]},"hours":{"description":"Opening hours per day.","items":{"properties":{"closeTime":{"description":"Closing time, HH:MM.","type":["string","null"]},"day":{"description":"Day of week, e.g. `mon`.","type":"string"},"mode":{"description":"`specific_hours`, `open_24h` or `appointment_only` (times are null then).","type":"string"},"openTime":{"description":"Opening time, HH:MM.","type":["string","null"]}},"required":["day","mode","openTime","closeTime"],"type":"object"},"type":"array"},"latitude":{"type":["number","null"]},"linkedFacebookPage":{"anyOf":[{"properties":{"id":{"type":"string"},"likes":{"type":["number","null"]},"name":{"type":["string","null"]}},"required":["id","name","likes"],"type":"object"},{"type":"null"}],"description":"Linked Facebook page and its follower count."},"longitude":{"type":["number","null"]},"memberSince":{"description":"When the business joined, as WhatsApp words it: \"Joined in January, 2026\".","type":["string","null"]},"memberSinceTs":{"description":"The same moment as a unix timestamp (seconds).","type":["number","null"]},"timezone":{"description":"IANA zone the opening hours are in.","type":["string","null"]},"verifiedLevel":{"description":"Meta verification tier.","type":["string","null"]},"websites":{"items":{"type":"string"},"type":"array"}},"required":["displayName","description","categories","email","websites","address","latitude","longitude","timezone","hours","memberSince","memberSinceTs","businessType","verifiedLevel","cartEnabled","commerceExperience","automatedType","linkedFacebookPage"],"type":"object"},{"type":"null"}],"description":"Business profile; null for personal accounts."},"checkedAt":{"description":"When this answer was fetched from WhatsApp (ISO 8601).","type":"string"},"devices":{"description":"Absent on the rare occasion WhatsApp sends no device list.","properties":{"count":{"description":"Linked devices including the phone itself, so 1 means phone only.","type":"number"},"hosted":{"description":"Served by the WhatsApp Business Platform (Cloud API) rather than a phone: a strong real-business signal.","type":"boolean"}},"required":["count","hosted"],"type":"object"},"hasWhatsApp":{"const":true,"description":"The number is a registered WhatsApp account.","type":"boolean"},"identity":{"properties":{"countryCode":{"description":"Country WhatsApp reports for the account (ISO 3166-1 alpha-2), not one guessed from the prefix.","type":["string","null"]},"lid":{"description":"WhatsApp's internal account id. Numbers that share one account share it.","type":["string","null"]}},"required":["countryCode","lid"],"type":"object"},"phone":{"description":"The number looked up, in E.164.","type":"string"},"profile":{"properties":{"about":{"description":"The \"about\" (status) text.","type":["string","null"]},"aboutRestricted":{"description":"True when an about text exists but privacy settings hide it, so `about` is empty.","type":"boolean"}},"required":["about","aboutRestricted"],"type":"object"}},"required":["phone","hasWhatsApp","accountType","identity","profile","business","checkedAt"],"type":"object"},{"properties":{"checkedAt":{"description":"When this answer was fetched from WhatsApp (ISO 8601).","type":"string"},"hasWhatsApp":{"const":false,"description":"The number is not on WhatsApp: a definitive answer, not a failure.","type":"boolean"},"phone":{"description":"The number looked up, in E.164.","type":"string"}},"required":["phone","hasWhatsApp","checkedAt"],"type":"object"}],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Whether a number is on WhatsApp and, if so: personal or business account, about text, country, linked devices and whether it runs on the Cloud API. Businesses add their public profile: name, description, categories, email, websites, address, coordinates, hours, join date and Facebook page. No photo; /v1/profile/full adds it. Query param: phone, with country code (e.g. +14155552671). Every answer is charged, “not on WhatsApp” included; a lookup WhatsApp does not answer is free.","last_updated":"2026-10-10T15:27:58.915Z","schemes":["exact"]}