Telegram Phone Checker

v1.0.0

Check if a phone number is registered on Telegram using the apipick Telegram Checker API. Returns registration status, Telegram user ID, username, first/last...

0· 560· 1 versions· 0 current· 0 all-time· Updated 4h ago· MIT-0

Install

openclaw skills install apipick-telegram-phone-check

apipick Telegram Phone Checker

Check Telegram registration status for any phone number with international country code.

Endpoint

POST https://www.apipick.com/api/check-phone-telegram

Authentication: x-api-key: YOUR_API_KEY header required. Get a free API key at https://www.apipick.com/dashboard/api-keys

Request

{"phone_number": "+1234567890"}

Phone number must include international country code (e.g. +86 for China, +1 for US).

Response

{
  "code": 200,
  "registered": true,
  "user_id": 123456789,
  "username": "example_user",
  "first_name": "John",
  "last_name": "Doe",
  "dc_id": 2,
  "message": "User found successfully"
}

If registered is false, user_id, username, first_name, last_name will be null/empty. Only publicly visible Telegram profile information is returned.

Error Codes

CodeMeaning
400Invalid phone number format
401Missing or invalid API key
402Insufficient credits

Cost: 1 credit per request

Usage Pattern

  1. Use $APIPICK_API_KEY env var as the x-api-key header value; if not set, ask the user for their apipick API key
  2. Ensure the phone number includes a country code
  3. Make the POST request
  4. Report registration status and available profile info

See references/api_reference.md for full response field descriptions.

Version tags

latestvk97cnexp1zx9ynpwqtwb2283hh81m9n8

Runtime requirements

EnvAPIPICK_API_KEY
Primary envAPIPICK_API_KEY