WhatsApp Number Checker API

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

Auth: x-api-key

Base URL: /api

Rate 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 --request GET \
  --url "https://wa-check-api.whatsabot.com/api/wa/check?phone=34605797764" \
  --header "x-api-key: YOUR_API_KEY"

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": "Service not configured" }
{ "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 --request GET \
  --url "https://wa-check-api.whatsabot.com/api/user/credits" \
  --header "x-api-key: YOUR_API_KEY"