Registration check
Check whether a phone number is registered with Telegram.
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.
{
"mode": "async",
"task_id": "xKj9aP3qLm7v",
"message": "Task queued."
}
Run a realtime registration check for one number, or process a list as a background job.
Check whether a phone number is registered with Telegram.
Submit an array of numbers or upload a CSV or TXT file up to 50 MB. Bulk jobs return a task ID.
Get a result for one phone number in the same request.
Poll the task status and download the result file when processing completes.
Create an API key, make your first request, and map the response fields into your product logic.
Create a key in the ZelNum app API Center and keep it on your server.
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"
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
}
}
Use a realtime product ID for one number or the bulk product slug for a list. See the API specification for request fields.
Use a native client library or call the REST API directly from your backend service.
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
});
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 |
Use Telegram registration results to review contact lists and choose a channel.
Check whether numbers on your onboarding list are registered with Telegram.
Add a Telegram registration result to CRM records for channel planning.
Use the registration result to review your community import and follow up on inconclusive records.
Answers about request limits, privacy, and what the check returns.