Skip to content
zelnum.com
Telegram API · Bulk jobs · List cleaning

Telegram Number Check API: Single and Bulk Registration Checks

Check whether one number is registered on Telegram, or verify a list through a bulk API job.

zelnum.com helps community and growth teams verify phone-based Telegram lists before onboarding, community imports, or CRM enrichment.

Bulk job limit
1,000,000 numbers
Signals
Registration
Workflow
Sync + async
Capabilities

API Features

Run a realtime registration check for one number, or process a list as a background job.

Registration check

Check whether a phone number is registered with Telegram.

Bulk verification

Submit an array of numbers or upload a CSV or TXT file up to 50 MB. Bulk jobs return a task ID.

Realtime lookup

Get a result for one phone number in the same request.

Poll for results

Poll the task status and download the result file when processing completes.

Developer quick start

Quick Start

Create an API key, make your first request, and map the response fields into your product logic.

1

Get your 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=tgValid" \
  -F "country=US" \
  -F "file=@telegram-us.csv"
3

Sample response

Example response for a file with 5,000 accepted numbers. Bulk jobs require at least 1,000 numbers.

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

Endpoints

Use a realtime product ID for one number or the bulk product slug for a list. See the API specification for request 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 library or call the REST API directly from your backend service.

Python
Node
Ruby
PHP
Go
.NET

API-first integration

Keep Telegram checks on your server, enrich records after validation, and avoid exposing keys in client-side code.

const result = await bulkchecker.telegram.check({
  phone: "+14155550198",
  includeBotRisk: true
});
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 Telegram browser tool.

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

Use Cases

Use Telegram registration results to review contact lists and choose a channel.

Community onboarding

Check whether numbers on your onboarding list are registered with Telegram.

B2B outreach enrichment

Add a Telegram registration result to CRM records for channel planning.

Community list triage

Use the registration result to review your community import and follow up on inconclusive records.

FAQ

Telegram Number Check API FAQ

Answers about request limits, privacy, and what the check returns.

Rate limits?
Bulk submissions and realtime checks each allow 10 requests per minute per API key. Bulk jobs run in the background.
Privacy?
The API is designed for verification and list hygiene workflows. It does not send a visible Telegram message to the checked user.
What does this check tell me?
The check reports registration. Online activity and bot detection are outside its scope.
Is this a Telegram API number check and Telegram phone lookup API?
For one number, use POST /api/v1/realtime/check/phone. For a list, use POST /api/v1/detect for an array or POST /api/v1/detect/file for a CSV or TXT file.