Changelog

What changed in the WhatsApp Profile API, its SDKs and apps, billing and this site. Newest first, written for the people who integrate it.

Scheduled breaking changes

None scheduled. A planned breaking change appears here at least 30 days before it takes effect.

All changes

All
API
Billing
SDKs & apps
Website
Privacy

November 2026

Improved
Privacy

Privacy Policy now covers Microsoft Clarity

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.

New
SDKs & apps

WhatsApp Number Checker 2.0 desktop app

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.

New
SDKs & apps

Country Profile Pictures desktop app

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.

Improved
API

Cursor pagination for /phone-numbers/search

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.

Improved
API

One page-size limit: up to 500 rows

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.

October 2026

New
Billing

Renew a key in place, with optional auto-renew

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.

September 2026

New
Billing

Monthly PayPal subscription and smaller starter packs

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.

New
Privacy

Number opt-out, and new Terms and Privacy Policy

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.

New
SDKs & apps

Telegram Mini App

Look up numbers inside Telegram with the same account and quota as the site. Open it from the bot's menu button or the /app command.

New
SDKs & apps

Bring your own Telegram or Discord bot

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.

New
API

Lookup webhooks

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.

New
Website

Email yourself the full lookup report

Signed-in users with a verified email can have the full report of a lookup sent to their inbox, laid out as a readable report.

Breaking
Billing

A live not-found answers HTTP 200 and counts as a request

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.

August 2026

New
API

Filter businesses by WhatsApp category

/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.

Improved
Website

New accounts confirm their email

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.

July 2026

New
API

Business enrichment and business filters

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.

New
SDKs & apps

Official SDKs for Node.js and Python

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.

June 2026

New
Website

Developer blog

Guides and comparisons on WhatsApp open-source libraries (Baileys, whatsapp-web.js, WPPConnect, whatsmeow) and the official Cloud API, with its own RSS feed.

How we change the API

  • 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.
  • Follow along with the RSS feed or the JSON Feed. For outages, see API status.

This policy applies from Nov 22, 2026. Entries before that date record changes as they shipped.

Co mówią nasi użytkownicy

Prawdziwe opinie od naszych zadowolonych klientów

Ładowanie recenzji...