Resolve a peer and return whether it exists on Telegram. Cheapest query; use it to pre-validate numbers/usernames before the about/picture queries. When exists=true, the response also includes the numeric Telegram user id, username (when the peer has one), display name, and a userHash that must be passed to Get About / Get Picture to authorize the heavier lookup. The userHash is valid for 24 hours. When the peer cannot be resolved, exists=false and reason carries the upstream error code (e.g. PHONE_NOT_OCCUPIED, USERNAME_NOT_OCCUPIED). The peer accepts three forms: +phone (digits with a leading +, e.g. +8613800138000), @username or a bare username, and user:<id> for a numeric user ID.

API Features

Real-time existence check Query live registration status to know instantly whether a peer is on Telegram before messaging or enriching records

Issues a userHash When the peer exists, returns a userHash used to authorize the Get About / Get Picture lookups (valid 24 hours)

Three peer forms Look up by phone number (+prefixed digits), @username / bare username, or numeric user ID (user:<id>)

Identity fields included A positive result carries the Telegram user id, username, and display name in one cheap call

Lightweight & cheap Returns only the resolution result plus userHash; no heavy profile payload, ideal for bulk pre-checks

Live API Demo

GET /api/project/telegram/check-exists

API Response (JSON)

{}

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Lead and contact validation: verify numbers are on Telegram before adding to campaigns or CRM
Messaging and campaigns: avoid sending to non-Telegram numbers to improve deliverability and reduce cost
List cleaning: bulk-check contact lists to flag inactive or non-Telegram numbers
Resolve a username or phone number to its numeric Telegram user ID

View Subscription Plans →

Check Telegram Peer Exists

API Features

Live API Demo

API Response (JSON)

Use Cases