Check one number, live
Instances
Check one number
GET /v1/instances//status — the live connection state of one number.
GET
Check one number, live
Checks the connection live and updates our stored record to match.
Notes
- Use this before a batch run, or right after a send returned
409 instance_not_connected, to confirm whether the number is really down. - It costs one upstream check, so it is slower than
GET /v1/instances. Do not call it in a tight loop for every message — check once before the batch. phone_numberis learned the first time we see the number connected, so it may benullon a number that has never paired.- If it turns out the same WhatsApp number is already connected on another of your instances, this returns
409 number_already_connected— the session that was already up keeps working.
Example
cURL
Node.js — check before a batch
If the messaging service cannot be reached, this returns
502 upstream_unavailable rather than guessing. That means “we do not know”, not “your number is down”.
