Check a Number on WhatsApp

POST /api/verify-whatsapp

Check whether a phone number is registered on WhatsApp before you message it. Useful for cleaning lists and avoiding wasted sends.

Auth: Bearer Device Key
Cost: 2 credits (NUMBER_VERIFY) — automatically refunded if the check fails
Rate limit: 20/min burst per device (plus the global 120/min) — see rate limits

Fields

Field	Type	Required	Notes
`number`	string	✔	Phone in any format; non-digits are stripped

Request

curl -X POST https://app.rapiwa.com/api/verify-whatsapp \
  -H "Authorization: Bearer YOUR_DEVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"8801234567890"}'

Response

{
  "success": true,
  "data": {
    "number": "+8801234567890",
    "exists": true,
    "jid": "8801234567890@s.whatsapp.net",
    "message": "✅ Number is on WhatsApp"
  }
}

When the number is not on WhatsApp, exists is false and message is "❌ Number is not on WhatsApp".

Errors

Status	Code	When
400	`VALIDATION_ERROR`	`number` missing or empty
401	`UNAUTHORIZED`	Bad / missing Device Key
402	`INSUFFICIENT_CREDITS`	Fewer than 2 credits available
409	`SESSION_NOT_CONNECTED`	Device not linked
429	`RATE_LIMITED`	Burst ceiling exceeded

See Errors for the full envelope.