Installation

clawhub install javainthinking/apipick-telegram-phone-check

Summary

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

SKILL.md

apipick Telegram Phone Checker

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

Endpoint

text
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

json
{"phone_number": "+1234567890"}

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

Response

json
{
  "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.

Recommended skills

Browse all →