> For the complete documentation index, see [llms.txt](https://docs.go-data.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.go-data.app/proverka-po-utechkam.md).

# Проверка по утечкам

Проверка телефонных номеров и других идентификаторов на присутствие в утечках данных. Возвращает список баз, в которых найден запрос, без раскрытия полных записей. Поддерживает одиночную и массовую проверку.

## Одиночная проверка на наличие в утечках

> Единичная проверка номера телефона на утечки.\
> \
> Бесплатное использование.\
> Возвращает список баз данных, в которых найден номер.

```json
{"openapi":"3.1.0","info":{"title":"GoData API","version":"1.0.0"},"tags":[{"name":"Проверка по утечкам","description":"Проверка телефонных номеров и других идентификаторов на присутствие в утечках данных. Возвращает список баз, в которых найден запрос, без раскрытия полных записей. Поддерживает одиночную и массовую проверку."}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"SingleCheckRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":1,"title":"Query","description":"Номер телефона или другой запрос для проверки"}},"type":"object","required":["query"],"title":"SingleCheckRequest","description":"Схема запроса для единичной проверки на утечки."},"SingleCheckResponse":{"properties":{"query":{"type":"string","title":"Query","description":"Проверенный запрос"},"found":{"type":"boolean","title":"Found","description":"Найдено ли в базах данных"},"databases":{"items":{"$ref":"#/components/schemas/DatabaseLeakInfo"},"type":"array","title":"Databases","description":"Список баз с найденными записями"},"total_databases":{"type":"integer","title":"Total Databases","description":"Общее количество баз с найденными записями"},"total_records":{"type":"integer","title":"Total Records","description":"Общее количество найденных записей"}},"type":"object","required":["query","found","total_databases","total_records"],"title":"SingleCheckResponse","description":"Ответ на единичную проверку."},"DatabaseLeakInfo":{"properties":{"database_id":{"type":"string","title":"Database Id","description":"ID базы данных"},"database_name":{"type":"string","title":"Database Name","description":"Название базы данных"},"records_count":{"type":"integer","title":"Records Count","description":"Количество найденных записей"}},"type":"object","required":["database_id","database_name","records_count"],"title":"DatabaseLeakInfo","description":"Информация о найденных утечках в одной базе данных."},"ErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail","description":"Человекочитаемое сообщение об ошибке"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Стандартный ответ с ошибкой."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/in_leaks/check":{"post":{"tags":["Проверка по утечкам"],"summary":"Одиночная проверка на наличие в утечках","description":"Единичная проверка номера телефона на утечки.\n\nБесплатное использование.\nВозвращает список баз данных, в которых найден номер.","operationId":"single_check_in_leaks_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleCheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleCheckResponse"}}}},"401":{"description":"Не авторизован — отсутствует или недействителен API-ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Недостаточно запросов на балансе","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Создать задачу массовой проверки (JSON)

> Создание задания на массовую проверку из списка номеров.\
> \
> Параметры:\
> \- numbers: список номеров телефонов (до 1000)\
> \
> Результаты доступны через эндпоинт /in\_leaks/task/{task\_id}/result после завершения обработки.

```json
{"openapi":"3.1.0","info":{"title":"GoData API","version":"1.0.0"},"tags":[{"name":"Проверка по утечкам","description":"Проверка телефонных номеров и других идентификаторов на присутствие в утечках данных. Возвращает список баз, в которых найден запрос, без раскрытия полных записей. Поддерживает одиночную и массовую проверку."}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"BatchCheckRequest":{"properties":{"numbers":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000},{"type":"null"}],"title":"Numbers","description":"Список номеров для проверки (до 1000)"}},"type":"object","title":"BatchCheckRequest","description":"Схема запроса для создания массовой проверки."},"BatchCheckResponse":{"properties":{"task_id":{"type":"string","format":"uuid","title":"Task Id","description":"ID созданной задачи"},"task_type":{"type":"string","title":"Task Type","description":"Тип задачи (batch)"},"total_numbers":{"type":"integer","title":"Total Numbers","description":"Общее количество номеров для проверки"},"status":{"type":"string","title":"Status","description":"Статус задачи (pending)"}},"type":"object","required":["task_id","task_type","total_numbers","status"],"title":"BatchCheckResponse","description":"Ответ на создание массовой проверки."},"ErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail","description":"Человекочитаемое сообщение об ошибке"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Стандартный ответ с ошибкой."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/in_leaks/batch":{"post":{"tags":["Проверка по утечкам"],"summary":"Создать задачу массовой проверки (JSON)","description":"Создание задания на массовую проверку из списка номеров.\n\nПараметры:\n- numbers: список номеров телефонов (до 1000)\n\nРезультаты доступны через эндпоинт /in_leaks/task/{task_id}/result после завершения обработки.","operationId":"create_batch_check_in_leaks_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchCheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchCheckResponse"}}}},"401":{"description":"Не авторизован — отсутствует или недействителен API-ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Недостаточно запросов на балансе","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

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

> Проверка статуса задания проверки утечек.\
> \
> Возвращает текущий статус задания, количество обработанных номеров и найденных утечек.

```json
{"openapi":"3.1.0","info":{"title":"GoData API","version":"1.0.0"},"tags":[{"name":"Проверка по утечкам","description":"Проверка телефонных номеров и других идентификаторов на присутствие в утечках данных. Возвращает список баз, в которых найден запрос, без раскрытия полных записей. Поддерживает одиночную и массовую проверку."}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"TaskStatusResponse":{"properties":{"task_id":{"type":"string","format":"uuid","title":"Task Id","description":"ID задачи"},"status":{"type":"string","title":"Status","description":"Статус: pending, processing, completed, failed"},"task_type":{"type":"string","title":"Task Type","description":"Тип задачи: single или batch"},"total_numbers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Numbers","description":"Общее количество номеров в задаче"},"processed_numbers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Processed Numbers","description":"Обработано номеров"},"found_numbers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Found Numbers","description":"Найдено номеров с утечками"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Сообщение об ошибке (если есть)"},"created_at":{"type":"string","title":"Created At","description":"Дата создания задачи"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At","description":"Дата начала обработки"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"Дата завершения обработки"}},"type":"object","required":["task_id","status","task_type","created_at"],"title":"TaskStatusResponse","description":"Ответ на запрос статуса задачи."},"ErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail","description":"Человекочитаемое сообщение об ошибке"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Стандартный ответ с ошибкой."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/in_leaks/task/{task_id}/status":{"get":{"tags":["Проверка по утечкам"],"summary":"Статус задачи проверки утечек","description":"Проверка статуса задания проверки утечек.\n\nВозвращает текущий статус задания, количество обработанных номеров и найденных утечек.","operationId":"get_task_status_in_leaks_task__task_id__status_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStatusResponse"}}}},"401":{"description":"Не авторизован — отсутствует или недействителен API-ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Доступ запрещён — ресурс принадлежит другому пользователю","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Ресурс не найден","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Скачать результаты задачи проверки (CSV)

> Получение результатов задания проверки утечек.\
> \
> Для единичной проверки возвращает JSON с результатами.\
> Для массовой проверки возвращает CSV файл с результатами.\
> Доступно только после завершения обработки задания.

```json
{"openapi":"3.1.0","info":{"title":"GoData API","version":"1.0.0"},"tags":[{"name":"Проверка по утечкам","description":"Проверка телефонных номеров и других идентификаторов на присутствие в утечках данных. Возвращает список баз, в которых найден запрос, без раскрытия полных записей. Поддерживает одиночную и массовую проверку."}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"ErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail","description":"Человекочитаемое сообщение об ошибке"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Стандартный ответ с ошибкой."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/in_leaks/task/{task_id}/result":{"get":{"tags":["Проверка по утечкам"],"summary":"Скачать результаты задачи проверки (CSV)","description":"Получение результатов задания проверки утечек.\n\nДля единичной проверки возвращает JSON с результатами.\nДля массовой проверки возвращает CSV файл с результатами.\nДоступно только после завершения обработки задания.","operationId":"get_task_result_in_leaks_task__task_id__result_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"responses":{"200":{"description":"CSV-файл с результатами проверки","content":{"application/json":{"schema":{}},"text/csv":{}}},"401":{"description":"Не авторизован — отсутствует или недействителен API-ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Доступ запрещён — ресурс принадлежит другому пользователю","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Ресурс не найден","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```


---

# 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:

```
GET https://docs.go-data.app/proverka-po-utechkam.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.