wtsp.dev

Endpoints (5 live)

• GET /v1/profile — 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. (0.006 USDC on Base)
• GET /v1/exists — Whether a number has a WhatsApp account, and nothing else: the cheapest way to clean a list before paying for profiles. /v1/profile gives the same answer plus the account's details. 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. (0.004 USDC on Base)
• GET /v1/carrier — The carrier and line type of any number, from the numbering plan: the network its range was issued to, mobile, fixed line or VoIP, plus country, region, time zones and national and international formats. Works whether or not the number is on WhatsApp. Ported numbers report their original carrier. Query param: phone, with country code (e.g. +447400123456). Only charged when a carrier is on record; numbers without one (the US and Canada among them) get a free 404. (0.004 USDC on Base)
• GET /v1/profile/full — Everything /v1/profile returns, plus the profile photo as a permanent URL and a content hash: an unchanged hash means an unchanged photo. The URL is null when the account has no photo or hides 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. (0.01 USDC on Base)
• POST /v1/credits — Prepaid credit for a wtsp.dev API key, in whole USDC. Without an API key a new key is issued; with one, it is topped up. (10 USDC on Base)