Get Session Status
View All Telegram Messaging API APIs →Return the current state of a session: its status (CREATED, WAITING_FOR_SCAN, WAITING_FOR_OTP, CONNECTING, CONNECTED, DISCONNECTED, LOGGED_OUT, or FAILED), the login mode, the phone number, and — while waiting for login — the qrImage (base64 data-URI) plus twoFactorRequired when a cloud password is needed. If the account is saved but offline, this call lazily reconnects it. Poll it after Create Session until status is CONNECTED.
API Features
Real-time status Reports the exact lifecycle state so you know when the session is ready to send
QR & 2FA payload While logging in, returns the qrImage and flags when a cloud password is required
Lazy reconnect Automatically reconnects an offline account that still has a saved login
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/get-session API Response (JSON)
{} Query Result
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Use Cases
- Drive a scan-to-login UI by polling until CONNECTED
- Health-check a session before sending a batch of messages
- Surface disconnect reasons in an operations dashboard