Skip to content
Check Number API Doc

WhatsApp Bulk Number Checker API: Fast Phone Number Verification (Example)

import CurlExample from ’../../components/CurlExample.astro’; import ApiUrl from ’../../components/ApiUrl.astro’;

Check the details of the WhatsApp of the input global number, whether it is whatsapp account

API Endpoints

Upload Detection File

Upload a file containing phone numbers for WhatsApp detection.

<CurlExample endpoint=“/wa/api/simple/tasks” method=“POST” headers={{ ‘X-API-Key’: ‘API-KEY’ }} />

Form Data:

  • file: Text file containing phone numbers (one per line)

Check Task Status

Check the status and results of a previously submitted task.

<CurlExample endpoint=“/wa/api/simple/tasks/cs9viu7i61pkfs4oavvg” method=“GET” headers={{ ‘X-API-Key’: ‘API-KEY’ }} params={{ ‘user_id’: ‘USER_ID’ }} />

Response Examples

Upload Success Response

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "file_name": "input.txt",
  "total_numbers": 100
}

Task Status Response

{
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "completed",
  "processed": 100,
  "total": 100,
  "results": [
    {
      "phone_number": "+1234567890",
      "has_whatsapp": true,
      "last_seen": "2024-10-19"
    },
    {
      "phone_number": "+1234567891",
      "has_whatsapp": false,
      "last_seen": null
    }
  ]
}

Parameters

ParameterTypeRequiredDescription
fileFileYesText file with phone numbers (one per line)
user_idStringYesYour user identifier
task_idStringYesTask ID returned from upload request

Status Codes

  • pending: Task is queued for processing
  • processing: Task is currently being processed
  • completed: Task has finished successfully
  • failed: Task encountered an error

Rate Limits

  • Maximum 1000 numbers per file
  • Maximum 10 concurrent tasks per user
  • API calls limited to 100 requests per minute