> For the complete documentation index, see [llms.txt](https://docs.geeknums.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geeknums.io/binance-bulk-number-checker-api-paketnaya-proverka.md).

# Binance Bulk Number Checker API: пакетная проверка

Binance Bulk Number Checker: Обрабатывайте входные значения через пакетный API и получайте перечисленные ниже поля результата.

## Формат входных данных

Загрузите текстовый файл, по одному номеру телефона в строке. Нормализуйте значения перед загрузкой; для телефонов рекомендуется формат E.164.

```
+14155552671+442071838750
```

{% stepper %}
{% step %}

## Создание задачи

`POST https://api.checknumber.ai/v1/tasks`

*Окно терминала*

```bash
curl --location 'https://api.checknumber.ai/v1/tasks' \--header 'X-API-Key: YOUR_API_KEY' \--form 'file=@"./input.txt"' \--form 'task_type="Binance"'
```

API возвращает ID задачи. Сохраните его и используйте для проверки статуса.

### Ответ при загрузке

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "pending",  "total": 5000,  "estimated_amount": {    "amount": "0.500000",    "currency": "USD"  },  "message": "Task created successfully"}
```

{% endstep %}

{% step %}

## Проверка статуса задачи

`POST https://api.checknumber.ai/v1/gettasks`

*Окно терминала*

```bash
curl --location 'https://api.checknumber.ai/v1/gettasks' \--header 'X-API-Key: YOUR_API_KEY' \--form 'task_id="d4g8o46p2jvh04o9uolg"'
```

Проверяйте статус, пока `status` не станет `exported`. Значения `pending` и `processing` не означают завершение.

### Ответ при обработке

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "processing",  "total": 5000,  "success": 2500,  "failure": 0}
```

### Экспортированный ответ

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "exported",  "total": 5000,  "success": 5000,  "failure": 0,  "result_url": "https://example-link-to-results.zip",  "actual_amount": {    "amount": "2.000000",    "currency": "USD"  }}
```

{% endstep %}

{% step %}

## Обработка файла результата

Скачивайте файл по `result_url` только после экспорта задачи. Сохраняйте имена возвращённых столбцов при дальнейшей обработке.
{% endstep %}
{% endstepper %}

## Поля результата

| Поле        | Описание                                                 | Пример       |
| ----------- | -------------------------------------------------------- | ------------ |
| `number`    | Номер телефона из переданного файла.                     | +14155552671 |
| `activated` | Показывает, был ли вход активным или зарегистрированным. | yes          |

## Поля ответа

| Поле               | Описание                                           |
| ------------------ | -------------------------------------------------- |
| `created_at`       | Время создания задачи.                             |
| `updated_at`       | Время последнего обновления статуса.               |
| `task_id`          | Уникальный идентификатор задачи.                   |
| `status`           | `pending`, `processing`, `exported` или `failed`.  |
| `total`            | Общее число обработанных входных значений.         |
| `success`          | Успешно обработанные значения.                     |
| `failure`          | Значения, обработка которых завершилась ошибкой.   |
| `result_url`       | URL для скачивания после экспорта задачи.          |
| `actual_amount`    | Итоговая сумма, если доступна.                     |
| `estimated_amount` | Расчётная сумма, возвращаемая при создании задачи. |

## Коды состояния

| Status | Описание                                                                            |
| ------ | ----------------------------------------------------------------------------------- |
| `200`  | Запрос выполнен успешно.                                                            |
| `202`  | Задача создана успешно, применена предварительная стоимость.                        |
| `400`  | Недопустимый файл, неподдерживаемый тип задачи или слишком мало корректных записей. |
| `401`  | API-ключ отсутствует или недействителен.                                            |
| `402`  | Недостаточно средств на счёте.                                                      |
| `404`  | Задача не найдена.                                                                  |
| `413`  | Загруженный файл слишком велик.                                                     |
| `500`  | Внутренняя ошибка сервера; повторите попытку позже.                                 |

## Рабочие примечания

* Задача выполняется асинхронно; используйте ID задачи для проверки статуса.
* Перед загрузкой проверьте ограничения продукта на входные данные.
* Ошибочные строки указаны в экспортированном результате и отражены в счётчиках задачи.
* Поля выше основаны на текущем live sample и могут измениться при изменении схемы экспорта.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.geeknums.io/binance-bulk-number-checker-api-paketnaya-proverka.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.