# Phone Checker

The Phone Checker module checks whether phone numbers are registered on Telegram. It does not message anyone -- it simply reports which numbers have active Telegram accounts. Results are saved as an Excel (XLSX) file.

![Phone Checker settings](/files/oI0wy3jdXSxqrEK1IGbJ)

## Settings Reference

### Method

| Setting          | Description                                                                                                              |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Check Method** | How to check phone numbers:                                                                                              |
|                  | **Import Contacts** -- adds phones as contacts in batch, then checks which ones are on Telegram. Faster for large lists. |
|                  | **Resolve Phone** -- checks each phone individually via link resolution. Slower but less likely to trigger restrictions. |

### Settings

| Setting                         | Description                                                                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Threads**                     | How many accounts to use for checking at the same time. Default: 3.                                                                                                      |
| **Batch Size**                  | How many phones to check per request (Import Contacts mode) or between long pauses (Resolve mode). Default: 5. Range: 1-20.                                              |
| **Batch Delay (sec)**           | Pause between batches to avoid triggering Telegram rate limits. Default: 10 seconds.                                                                                     |
| **Phone Delay (sec)**           | Pause between individual phone checks. Only visible in Resolve mode. Default: 1.5 seconds.                                                                               |
| **Timeout (sec)**               | How long to wait for each check operation. Default: 30 seconds.                                                                                                          |
| **Delete Contacts After Check** | Remove the added contacts from the account after checking. Only visible in Import Contacts mode. Recommended to keep enabled to avoid cluttering accounts with contacts. |

### Phone Numbers

Enter the phone numbers you want to check, one per line. Any format works:

```
+7 999 123-45-67
79991234567
+1-555-123-4567
15551234567
```

## How to Use

1. Go to **Phone Checker** in the sidebar
2. Select the **Check Method** (Import Contacts is recommended for most cases)
3. Paste your phone numbers in the **Phone Numbers** field
4. Select a **Proxy list**
5. In the **Accounts** section, select accounts to use for checking
6. Click **Start**

{% hint style="info" %}
Phone numbers are distributed evenly across your selected accounts. If one account gets rate-limited or fails, its remaining phones are redistributed to other healthy accounts.
{% endhint %}

## Understanding the Results

The Phone Checker creates an Excel file in `data/results/phone_checker/` with three sheets:

| Sheet              | Content                                 |
| ------------------ | --------------------------------------- |
| **All**            | Every phone number with full details    |
| **Registered**     | Only phones that have Telegram accounts |
| **Not Registered** | Only phones without Telegram accounts   |

For registered numbers, the following information is collected when available: User ID, Username, First Name, Last Name, Phone (visible in TG), Premium status, Verified, Bot, Scam, Fake, Has Photo, Last Online, and Restriction Reason.

{% hint style="info" %}
**Use small batch sizes (3-5)** and reasonable delays (10+ seconds) to avoid flood restrictions on your checking accounts.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mvs-3.gitbook.io/mvs-docs/modules/phone-checker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.