mirror of
https://github.com/bellingcat/telegram-phone-number-checker.git
synced 2026-06-07 19:08:31 +03:00
d86877a1c63ca5d542026755e39623a30e9efb15
telegram-phone-number-checker
This script lets you check whether a specific phone number is connected to a Telegram account.
To run it, you need:
- A Telegram account with an active phone number;
- Telegram 'API_ID' and 'API_HASH', which you can get by creating a developers account using this link: https://my.telegram.org/. Place these values in a .env file:
API_HASH=```
Then, run the script: `python3 telegram-phone-validation.py --phone_number +15558675309`
You can expect the following possible responses:
1. If available, you will receive the Telegram Username that is connected with this number.
2. 'Response detected, but no user name returned by the API for the number: {phone_number}'. This means that it looks like the number was used to create a Telegram account but the user did not choose a Telegram Username. It is optional to create a Username on Telegram.
3. 'ERROR: there was no response for the phone number: {phone_number}': There can be several reasons for this response. Either the phone number has not been used to create a Telegram account. Or: The phone number is connected to a Telegram account but the user has restricted the option to find him/her via the phone number. Or: another error occurred.
Languages
Python
100%