Telegram Username Checker API

Check whether Telegram usernames are registered and active. This product accepts usernames directly instead of phone numbers.

Input format

Upload a text file with one Telegram username per line. The following formats are accepted:

OpenAI
@Telegram
t.me/durov
https://t.me/example_user

A valid Telegram username is 5–32 characters, starts with a letter, and contains only letters, numbers, or underscores. Telegram usernames are case-insensitive.

The value written to the result files preserves the original spelling, case, and prefix from the uploaded file. Equivalent duplicate values are processed once, and the first valid representation is retained.

Create a task

POST https://api.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./usernames.txt"' \
--form 'task_type="tg_username"'

Parameter	Type	Required	Description
file	file	Yes	Text file containing one Telegram username per line
task_type	string	Yes	Set to tg_username

Successful task creation returns HTTP 202:

{
  "task_id": "d7abc123example",
  "status": "pending",
  "total": 4,
  "message": "Task created successfully",
  "created_at": "2026-08-11T10:00:00Z"
}

Query task status

POST https://api.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d7abc123example"'

When status is exported, download the ZIP archive from result_url.

Result files

The ZIP archive contains activated.txt, unregistered.txt, all.csv, and result.xlsx.

all.csv and result.xlsx contain these fields:

Field	Description	Example
username	Original username representation from the uploaded file	@OpenAI
activated	Whether the Telegram username is active	yes, no

Task status response

{
  "created_at": "2026-08-11T10:00:00Z",
  "updated_at": "2026-08-11T10:01:30Z",
  "task_id": "d7abc123example",
  "user_id": "YOUR_USER_ID",
  "status": "exported",
  "total": 4,
  "success": 4,
  "failure": 0,
  "result_url": "https://example.com/result.zip"
}