A carrier can offer a number for sale even when WhatsApp will not accept it. Checking that candidate before ordering avoids paying for a number you cannot connect through the intended setup flow.
How do I run Bird's number precheck?
Use bird whatsapp numbers precheck with the candidate number before buying it.
bird whatsapp numbers precheck +31612345678Supply the number in international format with a leading + and country code. The API request carries it in phone_number. You do not need to own it already.
The endpoint is POST /v1/whatsapp/numbers/precheck. Use a signed-in CLI or MCP grant with whatsapp_management:write, as required by the command reference.
| Flag | What it lets you inspect |
|---|---|
--example | The request body without credentials |
--dry-run | The resolved request without sending it |
--response-schema | The response fields |
An MCP client calls the same operation through whatsapp_numbers_precheck.
What do available and unavailable mean?
available means the check found no obstacle to connecting the number at that moment. unavailable means WhatsApp refused it.
| Outcome | What to do with a purchase candidate |
|---|---|
available | Continue the purchase checks, knowing the result does not reserve the number |
unavailable | Skip that candidate; investigate its registration if you already own it |
An unavailable number may already be registered on WhatsApp or may be a number WhatsApp cannot serve. The result does not distinguish those reasons, so do not infer one from the outcome alone.
A request failure is different from an unavailable result. Handle the returned API error before treating the candidate as unsuitable.
Does the check change anything?
Yes. It sends the candidate to WhatsApp. Meta can create a temporary entry under Bird's business account.
It does not connect the number to your workspace or reserve it for purchase. Check the candidate you intend to buy, because sweeping a list can leave temporary entries for unused numbers.
Reuse an Idempotency-Key when retrying the same check. During Bird's three-hour response window, the same key returns the stored answer instead of asking WhatsApp again.
The Idempotency-Replay response header identifies that replay. Once the response window ends, the same key can trigger a fresh check.
Where does the check fit into buying a number?
Check carrier availability and WhatsApp acceptance before placing the number order.
- Search with
bird numbers available list --country-code US. - Recheck the selected candidate with
bird numbers available get. - Run the WhatsApp precheck on that candidate.
- Order only after
available, usingbird numbers orders create.
A 404 from the carrier-availability recheck means you need another candidate. Complete any required organization verification in the dashboard before ordering.
A pending order still needs the carrier to complete provisioning. Wait for the order to settle before relying on the number.
What if I already own the number?
Use the outcome to investigate connection readiness rather than to make a purchase decision.
Bird's own-number setup cannot connect a number while its consumer or WhatsApp Business app registration remains active. Resolve that registration with the account owner before attempting the connection.
A number that passes still needs to complete the connection flow. Confirm that its status reaches Connected before using it as your branded sender.
Bird-managed senders are a separate option for the managed authentication and utility templates. They do not send your free-form content or receive customer replies into your workspace.
In short
Check before buying.
A number search does not establish WhatsApp compatibility. Run the precheck on the candidate you intend to purchase.
Interpret unavailable without inventing a reason.
The number may already be registered or may be unsupported. The result does not distinguish those cases.
Treat the precheck as a write.
It sends the number to WhatsApp and can create a temporary entry. It does not reserve or connect the number.
Reuse retry keys for the same check.
An idempotency replay returns the stored answer. That answer describes the earlier check, not a fresh availability guarantee.