The site and the checkout use Microsoft Clarity to find broken pages and confusing steps. It starts only where your analytics consent allows, masks what you type and the API keys shown on screen, and never records a lookup result page. The Privacy Policy describes it.
A free, open-source desktop app for Windows, macOS and Linux that checks lists of numbers with your own API key and exports the results. Version 2 works with a direct API key or a RapidAPI key.
A free, open-source desktop app that downloads the stored profile pictures matching your filters, with a CSV of every field. It never downloads the same picture twice.
Deep result pages no longer time out. Send sortBy=id and read data.nextCursor from each page, then pass it back as after=<cursor> to get the next one: every page is as fast as the first. With after, page is ignored. A malformed or reused cursor, a cursor with another sortBy, or a cursor on a full-text search answers 400 INVALID_CURSOR.
Action needed: If you walk more than a few thousand pages with page=, switch to after=.
The /phone-numbers listing and search endpoints accept limit up to 500. Before, they quietly returned 50 rows no matter what limit you sent. A limit above 500 is lowered to 500, not rejected.
Action needed: If you sent limit=100 or more and paged by 50, check your page math: you now get the rows you asked for.
Add credits to the API key you already have, from its dashboard or the checkout. Remaining credits are kept and the expiry moves forward, so nothing changes in your code. PayPal buyers can also turn on auto-renew for an existing key.
A 10,000-request pack sits between the 5K and 20K packs. At checkout, one-time orders and renewals can extend their validity to 180 or 365 days for a fee, for projects that use the API slowly over months.
An opted-out number's data is hidden from every channel and kept only in restricted storage, so the opt-out keeps being honored. To ask for erasure, email us after opting out; the Privacy Policy explains how the request is reviewed.
Direct API keys can be bought as a monthly PayPal subscription, and unused credits carry over between months. 5K and 20K starter packs join the 50K tier, and the pricing page now lists the direct tiers next to a talk-to-sales form for larger volumes.
Anyone can hide their own number from every channel on the opt-out page. An opted-out number answers HTTP 404 with code NUMBER_UNAVAILABLE on every endpoint and channel, and drops out of search and listings. The Terms of Service and Privacy Policy were rewritten.
Action needed: Treat NUMBER_UNAVAILABLE as final for that number: do not retry it.
Connect your own bot token on the Bots page and that bot answers number lookups in your groups and DMs, using your quota. A private bot answers only the people you approve; a public one gets a per-user hourly limit.
Get lookup.found, lookup.not_found and bulk.completed events pushed to your own HTTPS endpoint, a Discord channel or Slack. Generic endpoints are signed with Standard Webhooks headers (webhook-id, webhook-timestamp, webhook-signature). A failed delivery is retried after 30 seconds, 5 minutes, 30 minutes and 2 hours. Up to 5 endpoints per account, managed on the Webhooks page or through the /webhooks API with a direct key.
When a direct API key runs out (429) or expires (401), the error body now carries code, message, renewUrl, pricingUrl, dashboardUrl and support next to error, so your app can send the user straight to renewal.
When a live lookup finds that a number is not on WhatsApp, the API answers HTTP 200 on every channel. The body is unchanged: exists is false, status is 404 and code is NUMBER_NOT_FOUND. On direct API keys that answer now counts as one request. A not-found served from cache still answers HTTP 404 and does not count. This shipped before the notice policy below existed.
Action needed: Decide found or not found from exists (or code) in the body, never from the HTTP status.
/phone-numbers/search takes categories (up to 25 WhatsApp business category ids) and categoriesMode=any or all. Filter by id: the same category has a different display name in each account's language.
Accounts created on the site confirm their email address before their first lookup, and the confirmation email now comes from our own domain, so it lands in the inbox more often.
GET /number/{number} and /number_cache/{number} take businessEnrichment=1 to add the Trustpilot profile of a business's website domain. /phone-numbers/search adds hasWebsite, hasEmail and hasAddress (true or false) and the domain, email and address text filters.
whatsapp-data-sdk is on npm (TypeScript types, no dependencies) and on PyPI (typed, one dependency). Both cover every endpoint, map errors to typed exceptions, and include a cache-first helper that tries the cheaper cached lookup before a live one.
Guides and comparisons on WhatsApp open-source libraries (Baileys, whatsapp-web.js, WPPConnect, whatsmeow) and the official Cloud API, with its own RSS feed.
30 days' notice for breaking changes. A planned change that can break a working integration — a removed or renamed field, a changed type or status code, a retired endpoint or parameter — is posted here and in both feeds at least 30 days before it takes effect.
Two exceptions. Security or abuse emergencies, and changes WhatsApp makes on its side that we do not control. Those are posted as soon as we know, with what to do.
Additive changes are not breaking. New endpoints, new optional parameters and new response fields can appear at any time. Ignore fields you do not recognize instead of rejecting the response.
Deprecated means it still works. A deprecated field or endpoint keeps working until the date posted with it.