WhatsApp Bulk Number Checker Simple API

WhatsApp is a globally dominant messaging platform, and verifying account status at scale can provide valuable insights for businesses. This article introduces the WhatsApp Bulk Number Checker Simple API, which enables efficient verification of WhatsApp account status for multiple numbers simultaneously.

Main Features

The WhatsApp Bulk Number Checker Simple API offers essential verification capabilities:

Account Verification

Quick and reliable verification of WhatsApp account status for any phone number globally.

Bulk Processing

Process multiple numbers simultaneously through file upload, making it efficient for large-scale verification.

Real-time Status Updates

Monitor the progress of your bulk verification tasks with real-time status updates.

Usage Steps

File Upload

Upload a text file containing phone numbers in E.164 format:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file.txt"' \
--form 'task_type="ws"'

Get Task Details

Poll task status with POST https://api.checknumber.ai/v1/gettasks and form field task_id (see the curl example below). Legacy /wa/api/simple/... paths are not used.

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Request parameters (submit)

file: Plain text or CSV with one E.164 number per line.
task_type: Set to ws for WhatsApp registration checks (see official docs).

Response parameters (task object)

task_id: The ID of the task.
created_at: The time the task was created.
updated_at: The time the task was last updated.
status: The status of the task.
total: The total number of numbers in the task.
success: The number of successfully checked numbers.
failure: The number of failed rows.
result_url: The URL to download the result file when status is exported.

Request body (multipart)

Parameter	Type	Description
`file`	`file`	One phone number per line, E.164 format
`task_type`	string	`ws` — WhatsApp registration check

Response Body

Parameter	Type	Description
`task_id`	`string`	The ID of the created task
`created_at`	`string`	The creation time of the task
`updated_at`	`string`	The last update time of the task
`status`	`string`	The status of the task, e.g., pending, processing, completed, exported
`total`	`integer`	The total number of numbers in the task
`success`	`integer`	The number of successfully processed numbers
`failure`	`integer`	The number of failed numbers
`result_url`	`string`	The download address of the result file

Result Fields

The API returns basic verification information including:

Phone number (E.164 format)
WhatsApp account status (yes/no)

API Response Format

The API provides detailed task status information:

created_at: Task creation timestamp
updated_at: Last status update timestamp
task_id: Unique task identifier
status: Current task status (pending/processing/completed/exported)
total: Total numbers processed
success: Successfully processed numbers
failure: Failed processing attempts
result_url: Download URL for completed results

Request Parameters

For file upload:

Parameter	Description
`file`	`file`, Upload file, each line should contain one phone number in E.164 format
`task_type`	Use the literal `ws` for basic WhatsApp registration checks (docs).

For status check:

Parameter	Description
`task_id`	Task ID from create

FAQ

1. What is the processing capacity of the API?

The API can handle large batches of numbers efficiently, with real-time status updates on processing progress.

2. What format should the input file be in?

The input file should be a text file with one phone number per line in E.164 format (e.g., +41798284651).

3. What information does the API return?

The API returns basic verification information: whether a phone number has an active WhatsApp account or not.

4. What are the API response status codes?

200: Successful request (charged)
400: Invalid parameters or file format (free)
500: Internal server error (free)

5. What is the pricing for the API?

The price is $1 USD per 10,000 numbers for basic WhatsApp account status verification.

For more information about pricing and higher volume processing, please contact us.