> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Получение задания на удаление сессий: API > Didit: опрос статуса и счётчиков результатов массового удаления сессий через Batch Delete Sessions, которое вернуло 202, так как подошло более 20 сессий. Промпт для получения задания на удаление сессий Скопировать промпт в буфер обмена \

\`Goal: Read the progress of a bulk session deletion that POST /v3/sessions/delete/ answered with 202. That happens when more than 20 KYC sessions match the request, whether they are selected by session_numbers or with delete_all.

Endpoint: GET https://verification.didit.me/v3/sessions/delete/{job_id}/
Auth header: x-api-key: 

Path param:
\- job_id: the job_id returned with the 202.

curl:
curl 'https://verification.didit.me/v3/sessions/delete/JOB_ID/' \
-H 'x-api-key: YOUR_API_KEY'

Response 200:
\{
"job_id": "",
"status": "PROCESSING",            // PENDING | PROCESSING | COMPLETED | FAILED
"total": 250,                      // sessions selected when the deletion was requested
"processed": 100,                  // sessions the job has finished with so far
"outcomes": {"deleted": 82, "none": 18, "retained_with_user": 0, "ineligible_no_vendor_user": 0, "failed_retryable": 0, "already_deleted": 0},
"deleted_child_verifications": 0,  // always 0 for jobs from POST /v3/sessions/delete/ (KYC sessions only)
"error": null,                     // why the deletion stopped, when status is FAILED
"created_at": "",
"completed_at": null
}

outcomes counts:
\- deleted: sessions deleted together with their face embedding.
\- none: sessions deleted that had no face embedding.
\- retained_with_user: sessions deleted while one image-free biometric template was retained for their User, as the request or the application policy asked.
\- ineligible_no_vendor_user: retention was requested but the session had no linked User; the session and its embedding were deleted.
\- failed_retryable: sessions reported as not deleted. The job retries a group it could not delete by itself instead of counting it here.
\- already_deleted: selected sessions that were already deleted, for example by another request, when the job reached them.

Polling: request the job every few seconds while status is PENDING or PROCESSING; stop at COMPLETED or FAILED. The job never lists which sessions it deleted, only counts. A FAILED job explains why in error; the sessions it had not reached are still in place, so repeat the deletion request to delete them. Deletion is permanent and irreversible.

Failure modes:
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401). { "detail": "You do not have permission to perform this action." }
\- 404: no such job for this application (a job is only visible to the application that created it).

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
Вставьте в ## ОбзорВозвращает сведения о массовом удалении сессий, запущенном через [Пакетное удаление сессий](https://docs.didit.me/ru/management-api/sessions/batch-delete.md): его статус, количество обработанных сессий и количество сессий по каждому результату.Когда под пакетное удаление попадает более 20 сессий KYC, отобранных через `session_numbers` или с помощью `delete_all`, запрос возвращает `202` с заданием в статусе `PENDING`, а сессии удаляются в фоновом режиме. Опрашивайте этот endpoint каждые несколько секунд, пока `status` не станет `COMPLETED` или `FAILED`.Каждая сессия, которую удаляет задание, удаляется точно так же, как при [Удалении сессии](https://docs.didit.me/ru/sessions-api/delete-session.md): удаляются сама сессия, каждая попытка верификации в ней и все её сохранённые файлы, а URL медиафайлов перестают работать. Удаление является безвозвратным и необратимым.Задание сообщает только количества. Оно никогда не перечисляет, какие сессии удалило.## Статус задания| `status` | Значение | | - | - | | `PENDING` | Принято, но ещё не запущено. | | `PROCESSING` | Идёт удаление; `processed` и `outcomes` обновляются. | | `COMPLETED` | Каждая выбранная сессия учтена в `outcomes`. | | `FAILED` | Задание остановилось раньше времени, причину показывает `error`. Сессии, до которых задание не дошло, остаются на месте: повторите запрос на удаление, чтобы удалить их. |Задание `delete_all` удаляет только сессии, созданные до запроса. Сессии, начатые во время его выполнения, не удаляются.## Количество результатов| Ключ `outcomes` | Значение | | - | - | | `deleted` | Сессии, удалённые вместе с их эмбеддингом лица. | | `none` | Удалённые сессии, у которых не было эмбеддинга лица. | | `retained_with_user` | Сессии, удалённые, при этом один биометрический шаблон без изображения был сохранён для соответствующего пользователя, так как того потребовал запрос или политика приложения. См. [Удаление сессии](https://docs.didit.me/ru/sessions-api/delete-session.md#биометрические-данные-лица-удалить-или-сохранить). | | `ineligible_no_vendor_user` | Сохранение было запрошено, но к сессии не был привязан пользователь. Сессия и её эмбеддинг лица были удалены. | | `failed_retryable` | Сессии, помеченные как не удалённые. Задание повторно пытается удалить группу, которую не смогло удалить самостоятельно, вместо того чтобы учитывать её здесь. | | `already_deleted` | Выбранные сессии, которые уже были удалены, например другим запросом, к моменту, когда задание до них дошло. |Счётчик `deleted_child_verifications` учитывает верификации, которые были созданы удаляемыми верификациями бизнеса и удалены вместе с ними. Для задания, запущенного через [Пакетное удаление сессий](https://docs.didit.me/ru/management-api/sessions/batch-delete.md), он всегда равен `0`, так как это удаление касается только сессий KYC.## РазрешенияЛюбой активный API-ключ приложения может вызвать этот endpoint. Задание видно только приложению, которое его создало; любой другой `job_id` возвращает `404`.## Связанные материалы- [Пакетное удаление сессий](https://docs.didit.me/ru/management-api/sessions/batch-delete.md) - [Удаление сессии](https://docs.didit.me/ru/sessions-api/delete-session.md) - [Хранение данных](https://docs.didit.me/ru/console/data-retention.md) ## OpenAPI ````yaml ru/openapi-25.json GET /v3/sessions/delete/{job_id}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/sessions/delete/{job_id}/: get: tags: - Sessions summary: Получить задачу массового удаления сессий description: >- Прогресс массового удаления сессий, на запрос которого `POST /v3/sessions/delete/` вернул `202` (более 20 подходящих сессий, выбранных по `session_numbers` или с помощью `delete_all`). Опрашивайте раз в несколько секунд, пока `status` равен `PENDING` или `PROCESSING`; прекратите опрос, когда статус изменится на `COMPLETED` или `FAILED`. Задача сообщает, сколько сессий завершилось с каждым из исходов и сколько сессий уже обработано, но никогда не указывает, какие именно сессии были удалены. Задача со статусом `FAILED` содержит причину в поле `error`; сессии, до которых задача ещё не дошла, остаются на месте, поэтому повторите запрос на удаление, чтобы удалить их. **Аутентификация:** API-ключ в заголовке `x-api-key`. Задача видна только тому приложению, которое её создало; любой другой `job_id` возвращает `404`. При отсутствии или недействительности учётных данных возвращается `403`; этот API никогда не возвращает `401`. operationId: get_session_deletion_job parameters: - name: job_id in: path required: true schema: type: string format: uuid description: >- Параметр `job_id`, возвращённый вместе со статусом `202` из `POST /v3/sessions/delete/`. responses: '200': description: Задание. content: application/json: schema: $ref: '#/components/schemas/SessionDeletionJob' examples: Processing: value: job_id: 5b8f2c1e-7d3a-4f6b-9e2c-1a0d8f7e6c5b status: PROCESSING total: 250 processed: 100 outcomes: deleted: 82 none: 18 retained_with_user: 0 ineligible_no_vendor_user: 0 failed_retryable: 0 already_deleted: 0 deleted_child_verifications: 0 error: null created_at: '2026-10-09T10:15:00Z' completed_at: null Completed: value: job_id: 5b8f2c1e-7d3a-4f6b-9e2c-1a0d8f7e6c5b status: COMPLETED total: 250 processed: 250 outcomes: deleted: 204 none: 44 retained_with_user: 0 ineligible_no_vendor_user: 0 failed_retryable: 0 already_deleted: 2 deleted_child_verifications: 0 error: null created_at: '2026-10-09T10:15:00Z' completed_at: '2026-10-09T10:16:40Z' Failed: value: job_id: 5b8f2c1e-7d3a-4f6b-9e2c-1a0d8f7e6c5b status: FAILED total: 250 processed: 100 outcomes: deleted: 82 none: 18 retained_with_user: 0 ineligible_no_vendor_user: 0 failed_retryable: 0 already_deleted: 0 deleted_child_verifications: 0 error: >- The deletion stopped before it finished. The sessions it had not reached are still in place; repeat the request to delete them. created_at: '2026-10-09T10:15:00Z' completed_at: '2026-10-09T10:15:52Z' '403': description: >- Отсутствует API-ключ. При отсутствии ключа возвращается `403`; при неверном, отозванном или истекшем ключе возвращается `401`. content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid API key: summary: Заголовок x-api-key отсутствует, либо ключ недействителен value: detail: You do not have permission to perform this action. '404': description: >- Задания на удаление с таким `job_id` для вызывающего приложения не существует. Задания видны только создавшему их приложению. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl 'https://verification.didit.me/v3/sessions/delete/JOB_ID/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.retrieve_deletion_job( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.retrieveDeletionJob("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.RetrieveDeletionJob(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().retrieveDeletionJob("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- sessions->retrieveDeletionJob('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.retrieve_deletion_job("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.RetrieveDeletionJobAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SessionDeletionJob: type: object description: >- Массовое удаление сессий, выполняющееся в фоновом режиме: прогресс и количество по результатам, без указания того, какие именно сессии были удалены. properties: job_id: type: string format: uuid description: Опрашивайте `GET /v3/sessions/delete/{job_id}/` с этим id. status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED description: >- `PENDING`: принято, ещё не запущено. `PROCESSING`: удаление; `processed` и `outcomes` обновляются. `COMPLETED`: учтена каждая выбранная сессия. `FAILED`: задача завершилась досрочно; см. `error`. total: type: integer description: Сессии, выбранные при запросе удаления. processed: type: integer description: Сессии, обработку которых задание завершило к настоящему моменту. outcomes: type: object description: >- Сколько сессий завершилось с каждым из исходов. Все ключи присутствуют всегда. properties: deleted: type: integer description: Сессии, удалённые вместе с их эмбеддингом лица. none: type: integer description: Удалённые сессии, не содержавшие эмбеддинг лица. retained_with_user: type: integer description: >- Сессии, удалённые с сохранением одного биометрического шаблона без изображения для их пользователя в соответствии с запросом или политикой приложения. ineligible_no_vendor_user: type: integer description: >- Сессии, удалённые вместе с их эмбеддингом лица из-за того, что было запрошено сохранение, но у них не было привязанного пользователя. failed_retryable: type: integer description: >- Сессии, о которых сообщено как о неудалённых. Задание повторно пытается удалить группу, которую ему не удалось удалить самостоятельно, вместо того чтобы учитывать её здесь. already_deleted: type: integer description: >- Выбранные сессии, которые уже были удалены, например другим запросом, когда задача дошла до них. deleted_child_verifications: type: integer description: >- Верификации, созданные удалёнными верификациями бизнеса, удалённые вместе с ними. Всегда `0` для задачи, запущенной через `POST /v3/sessions/delete/`, которая удаляет только сессии KYC. error: type: string nullable: true description: >- `null`, если `status` не равен `FAILED`; в противном случае указана причина остановки удаления. Сессии, до которых задание не дошло, остаются на месте: повторите запрос, чтобы удалить их. created_at: type: string format: date-time description: Когда было запрошено удаление. completed_at: type: string format: date-time nullable: true description: Время завершения задачи; `null` во время выполнения. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.