Check Whether a Peer Exists
View All Telegram Messaging API APIs →Resolve a peer and report whether it exists on Telegram. Pass the peer (@username, +phone, or a typed user:<id> / chat:<id> / channel:<id>) in the path. Returns exists with the resolved id, username, and display name when found, or exists=false with a reason when the peer cannot be resolved. Use it to validate recipients before sending to improve deliverability.
API Features
Recipient validation Confirm a peer resolves before you attempt to message it
Resolved identity Returns the id, username, and display name when the peer exists
Honest negatives exists=false with a reason instead of an error when unresolvable
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
GET
/api/project/telegram-messaging/check-exists API Response (JSON)
{} Query Result
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Use Cases
- Pre-send validation to avoid messaging non-existent peers
- List hygiene: flag invalid usernames or numbers in a contact list
- Signup flows: confirm Telegram availability before choosing it as a channel