Phone Numbers

Manage and verify WhatsApp Business phone numbers — check if a number is on WhatsApp, validate contacts in bulk, and monitor your account quality ratings.

Number Verification

Check whether any phone number is registered and active on WhatsApp before sending

Bulk Lookup

Validate up to 1,000 numbers in a single API call to keep your contact list clean

Registered Numbers

List and manage the WhatsApp Business phone numbers linked to your Sendexa account

Quality Ratings

Monitor Meta quality ratings and messaging limits for each registered number

Authentication Required

Use Basic Auth with your dashboard Base64 token for all phone number endpoints.

Lookup Speed

<300ms

single number check

Bulk Limit

1,000

numbers per request

WA Coverage

180+

countries supported

Quality Tiers

Green, Yellow, Red

GET

/v1/whatsapp/numbers/check

Verify

Stable

Query Parameters

Parameter	Type	Description
phone	string	Phone number in E.164 format (e.g. 233244000000)

Response

JSON

{
  "success": true,
  "data": {
    "phone": "233244000000",
    "isWhatsApp": true,
    "displayName": "Kofi",
    "type": "individual"
  }
}

POST

/v1/whatsapp/numbers/bulk-check

Bulk

Stable

Request Body

application/json

JSON

{
  "phones": [
    "233244000001",
    "233244000002",
    "233244000003"
  ]
}

Response

JSON

{
  "success": true,
  "data": {
    "results": [
      { "phone": "233244000001", "isWhatsApp": true,  "type": "individual" },
      { "phone": "233244000002", "isWhatsApp": false },
      { "phone": "233244000003", "isWhatsApp": true,  "type": "business" }
    ],
    "total": 3,
    "registered": 2,
    "notRegistered": 1
  }
}

GET

/v1/whatsapp/numbers

Account Numbers

Stable

Response

JSON

{
  "success": true,
  "data": {
    "numbers": [
      {
        "id": "wba_num_abc123",
        "phone": "233200000001",
        "displayName": "Sendexa Commerce",
        "verifiedName": "Sendexa Limited",
        "status": "CONNECTED",
        "qualityRating": "GREEN",
        "messagingLimit": "TIER_10K",
        "webhookUrl": "https://yourserver.com/webhooks/whatsapp",
        "connectedAt": "2024-01-01T08:00:00Z"
      }
    ],
    "total": 1
  }
}

Quality Ratings

Rating	Label	Description
GREEN	High Quality	Low block rate, good delivery. No restrictions.
YELLOW	Medium Quality	Elevated block rate. Monitor closely.
RED	Low Quality	High block rate. Messaging limits applied.

Messaging Limits

Tier	24h Limit	How to Upgrade
TIER_1K	1,000	Send 1K+ unique users in 30 days
TIER_10K	10,000	Send 10K+ unique users in 30 days
TIER_100K	100,000	Send 100K+ unique users in 30 days
TIER_UNLIMITED	Unlimited	Business verification required

Try It Yourself

GET

https://api.sendexa.co/v1/whatsapp/numbers/check?phone=233244000000

Code Examples

Bash

# Check a single number
curl -X GET 'https://api.sendexa.co/v1/whatsapp/numbers/check?phone=233244000000' \
  -H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN'

# Bulk check
curl -X POST 'https://api.sendexa.co/v1/whatsapp/numbers/bulk-check' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN' \
  -d '{ "phones": ["233244000001", "233244000002", "233244000003"] }'

# List account numbers
curl -X GET 'https://api.sendexa.co/v1/whatsapp/numbers' \
  -H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN'

Rate Limits

Individual number lookups per minute

300 requests single checks/min

Bulk validation requests per minute

20 requests bulk checks/min

Total numbers verified per day

50000 requests numbers/day

HTTP Status Codes

Code	Status	Description
200	OK	Request successful
400	Bad Request	Invalid phone number format
401	Unauthorized	Invalid or missing credentials
404	Not Found	Number not found in your account
429	Too Many Requests	Rate limit exceeded

Best Practices

Use bulk-check to validate your contact list before a campaign — only send to verified WhatsApp numbers
Cache lookup results for up to 24 hours to reduce unnecessary API calls
Monitor your quality rating daily — a drop to RED will limit your messaging capacity
Maintain a GREEN rating by only messaging opted-in users and responding promptly to inbound messages