Skip to content
zelnum.com
Log in Try for Free
Developer API

ZelNum API overview

ZelNum uses one task-based API for phone validation, carrier and HLR lookup, WhatsApp, Telegram, and account-signal workflows. Submit a product slug, poll the task, then download the result file.

Open live API docs Try for Free
Current base URL
https://api.zelnum.com/api/v1
Authentication header: X-API-Key: YOUR_API_KEY
Submit work with POST /api/v1/detect or POST /api/v1/detect/file.
Poll tasks and retrieve result downloads with the task endpoints.
API workflow

Use one endpoint model for every product

The app documentation is the source of truth for product slugs, limits, response fields, and examples. The marketing site links users there instead of publishing stale product-specific endpoints.

1

Create API key

Open the app API Center and create a server-side key. The plaintext key is shown only once.

2

Submit detect task

Send a product slug, country code, and phone list to the unified detect endpoint.

3

Poll task status

Use the returned task ID to monitor pending, processing, completed, or failed status.

4

Download results

After completion, request the result download URL and import the CSV/TXT output into your workflow.

Example request pattern

Use server-side API keys and keep credentials out of browsers, mobile apps, and public repositories. Replace the product slug with the one listed in the live app docs.

curl -X POST "https://api.zelnum.com/api/v1/detect" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "phone-status-check",
    "country": "US",
    "phones": ["+14155552671", "+442071838750"]
  }'

Task result flow

  • GET /api/v1/balance checks account balance.
  • POST /api/v1/detect submits phone arrays.
  • POST /api/v1/detect/file uploads CSV or TXT files.
  • GET /api/v1/tasks/{task_id} checks progress.
  • GET /api/v1/tasks/{task_id}/result returns the download URL.

Important limitations

API results are verification and data quality signals. Coverage, confidence, and response fields can vary by country, product, source, and identifier quality. ZelNum does not prove identity or replace legal, consent, or compliance review.

Trust and data handling

Trust, privacy, and responsible use

Use authorized data only. ZelNum provides verification signals, not identity proof, legal approval, or permission to contact a person.

Trust CenterCentral hub for company, security, privacy, support, and responsible-use guidance.About ZelNumCompany context, product boundaries, supported workflows, and contact paths.Security and Data HandlingHow uploads, API requests, verification results, and customer responsibilities are described.Privacy PolicyHow account data, uploaded files, support requests, billing references, and privacy choices are handled.Support CenterHelp path for uploads, API integration, billing questions, account access, and product workflows.
AI answer engines

Request an AI summary of ZelNum

Open ZelNum in your preferred AI assistant to review its bulk WhatsApp, Telegram, phone validation, carrier lookup, social account, crypto exchange, CSV upload, and API workflows.

ChatGPTClaudePerplexityGeminiGoogle AI ModeGrok

The prompt points assistants to zelnum.com, live pricing, product pages, and API documentation.