Skip to content
zelnum.com
Realtime API · Bulk jobs · Browser upload

WhatsApp Number Checker API and No-Code CSV Upload

Use the REST API for automated WhatsApp registration checks or upload a CSV in the dashboard without writing code. Both workflows check registration without sending a message.

The dashboard is useful for occasional lists. The API lets you check new records as they arrive or submit files from a recurring workflow.

Batch capacity
1,000,000 rows / task
Privacy
No messages sent
CSV or TXT limit
50 MB
Capabilities

API Capabilities

Use the unified ZelNum API for WhatsApp product slugs, bulk jobs, account signals, and async result downloads.

Product slug routing

Choose the WhatsApp product slug from the app docs and submit it through the shared detection endpoint.

Bulk API jobs

Submit a batch request and receive a job ID for high-volume list processing.

Poll for results

Poll the task ID and download the results when the job is complete.

Choose a WhatsApp check workflow

WorkflowWhat you submitUsage cost
No-code dashboardA CSV or TXT file from your CRM or spreadsheet$0.5 per 10,000 numbers checked
Bulk APIA file or an array from your backend$0.5 per 10,000 numbers checked
Realtime APIOne number per request$0.008 per check

With the dashboard, export your list, upload it, then import the results into your own system. ZelNum provides verification results. Messaging and CRM updates are handled in your own tools.

Developer quick start

Quick Start

Create a key, call the endpoint, and store the response fields your product needs.

1

Get API key

Create a key in the ZelNum app API Center and keep it on your server.

2

Submit a bulk file

curl -X POST "https://api.zelnum.com/api/v1/detect/file" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "product=waValid" \
  -F "country=US" \
  -F "file=@whatsapp-us.csv"
3

JSON response example

Example response for a file with 5,000 accepted numbers. A bulk job requires at least 1,000 numbers.

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "message": "Task queued.",
  "summary": {
    "total": 5000,
    "cost_deducted": 0.25
  }
}
Reference

Endpoints

Use the realtime product ID for a single check and the bulk product slug for a list. See the API specification for request and response fields.

Endpoint
Mode
Best for
Response

POST /api/v1/realtime/check/phone

Realtime
One phone number
Result in the same request

POST /api/v1/detect

Async
Phone array jobs
Task ID

POST /api/v1/detect/file

Async
CSV/TXT uploads
Task ID

GET /api/v1/tasks/{task_id}/result

Polling
Completed jobs
Download URL
SDKs

SDKs

Use a native client or call the REST API directly from your backend service.

Python
Node
Ruby
PHP
Go
.NET
Pay as you go

Pricing

API checks use prepaid credits. Top-ups start at $20, with no monthly fee. See the full pricing catalog.

For a manual spot check, use the free WhatsApp browser tool.

API workflow Minimum Rate
Bulk job 1,000 rows $0.5 per 10,000 rows
Realtime lookup 1 check $0.008 per check
Developer workflows

Use Cases for Developers

Build WhatsApp availability checks into the points where bad numbers are most expensive.

Campaign list pre-check

Spot unregistered or low-quality WhatsApp numbers before campaign upload, outreach, or community list import.

Campaign pre-validation

Clean large campaign lists before upload to protect spend, deliverability, and sender reputation.

CRM enrichment

Add WhatsApp status fields to lead records, customer profiles, and routing rules.

Comparison

Compare with WA Business API

The official messaging API and a verification API solve different developer problems.

WA Business API

  • Built for approved business messaging and conversations.
  • Requires business setup, templates, and platform-specific sending rules.
  • Best when you need to send messages after consent and approval.

zelnum.com WhatsApp API

  • Built for verification, list hygiene, and bulk list segmentation.
  • Checks WhatsApp availability without sending a visible message.
  • Best before campaigns, CRM imports, community outreach, and list cleanup.
FAQ

WhatsApp Number Check API FAQ

Answers about limits, privacy, business account requirements, and reliability.

API rate limits?
Bulk submissions and realtime checks each have a limit of 10 requests per minute per API key. Bulk jobs run in the background, so this is a request limit.
Privacy & data handling?
The API is designed for list hygiene and verification workflows, with no visible WhatsApp message sent to the checked number.
Can I check via API without WA Business account?
Yes. This API is for verification and enrichment, not for sending WhatsApp messages from your business account.
Support options?
Higher-volume plans can include support response targets and dedicated throughput planning.
Is this the WhatsApp checker API and WhatsApp number lookup API?
For one number, use POST /api/v1/realtime/check/phone. For a list, submit an array to POST /api/v1/detect or upload a file to POST /api/v1/detect/file.