- name
- apipick-telegram-check
- description
- Check if a phone number is registered on Telegram using the apipick Telegram Checker API. Returns registration status, Telegram user ID, username, first/last name, and data center ID. Use when the user wants to verify Telegram registration for a phone number, find a Telegram username by phone number, or check whether someone uses Telegram. Requires an apipick API key (x-api-key). Get a free key at https://www.apipick.com.
- metadata
- openclaw
- requires
- env
- primaryEnv
- APIPICK_API_KEY
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-telegramAuthentication: 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
| Code | Meaning |
|---|---|
| 400 | Invalid phone number format |
| 401 | Missing or invalid API key |
| 402 | Insufficient credits |
Cost: 1 credit per request
Usage Pattern
- Use
$APIPICK_API_KEYenv var as thex-api-keyheader value; if not set, ask the user for their apipick API key - Ensure the phone number includes a country code
- Make the POST request
- Report registration status and available profile info
See references/api_reference.md for full response field descriptions.