WhatsApp Number Checker API

Verify if a phone number is registered on WhatsApp and manage API credits.

Auth: x-api-keyBase URL: /apiRate limit: 1000 req/hour

Authorization

Send your API key in the request header.

Include the following header in every request:

x-api-key: YOUR_API_KEY

Endpoint: Check WhatsApp Number

Verify whether a phone number exists on WhatsApp.

GET/api/wa/check

Query parameters:

phone (required): E.164 or digits, e.g. 34605797764

Success response

{
  "code": 0,
  "result": {
    "exist": true
  }
}

Examples

cURL

curl --request GET \
  --url "https://wa-check-api.whatsabot.com/api/wa/check?phone=34605797764" \
  --header "x-api-key: YOUR_API_KEY"

Node (fetch)

const res = await fetch('https://wa-check-api.whatsabot.com/api/wa/check?phone=34605797764', {
  headers: { 'x-api-key': process.env.API_KEY }
})
const data = await res.json()
// { code: 0, result: { exist: boolean } }

Error codes

{ "code": 1001, "message": "Missing API key" }
{ "code": 1002, "message": "Invalid phone parameter" }
{ "code": 1003, "message": "Invalid API key" }
{ "code": 1004, "message": "Insufficient credits" }
{ "code": 1005, "message": "Rate limit exceeded" }
{ "code": 1006, "message": "Upstream service error" }
{ "code": 1007, "message": "Failed to deduct credit" }
{ "code": 1000, "message": "Internal error" }

Endpoint: Get Available Credits

Return the current available total credits for the API key.

GET/api/user/credits

No query params. Auth header required.

Success response

{
  "code": 0,
  "result": { "total": 42 }
}

Example

cURL

curl --request GET \
  --url "https://wa-check-api.whatsabot.com/api/user/credits" \
  --header "x-api-key: YOUR_API_KEY"

Node (fetch)

const res = await fetch('https://wa-check-api.whatsabot.com/api/user/credits', {
  headers: { 'x-api-key': process.env.API_KEY }
})
const data = await res.json()
// { code: 0, result: { total: number } }

WA Number Checker

The Most Trusted WhatsApp Number Checker Online - Fast, Accurate, and Secure

Products

Links

Need Help?

Send us an email at help@whatsabot.com if you have any questions. We'll help you out.