> ## 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. # Sitzungs-Löschjob abrufen – Didit Management API > Status und Ergebniszahlen eines Sitzungs-Löschjobs in Didit abfragen, der mit 202 angelegt wurde, weil mehr als 20 Sitzungen passten. Prompt: Löschjob für Sitzungen abrufen Prompt in die Zwischenablage kopieren \

\`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.`

\
Einfügen in ## ÜberblickGibt eine Massenlöschung von Sitzungen zurück, die mit [Mehrere Sitzungen löschen](https://docs.didit.me/de/management-api/sessions/batch-delete.md) gestartet wurde: ihren Status, wie viele Sitzungen verarbeitet wurden und wie viele mit welchem Ergebnis endeten.Wenn ein Massenlöschvorgang mehr als 20 KYC-Sitzungen betrifft, die über `session_numbers` ausgewählt oder mit `delete_all` festgelegt wurden, gibt die Anfrage `202` mit einem Job im Status `PENDING` zurück, und die Sitzungen werden im Hintergrund gelöscht. Fragen Sie diesen Endpoint alle paar Sekunden ab, bis `status` den Wert `COMPLETED` oder `FAILED` hat.Jede Sitzung, die der Job löscht, wird genauso gelöscht wie bei [Sitzung löschen](https://docs.didit.me/de/sessions-api/delete-session.md): Die Sitzung, alle Verifizierungsversuche, die sie enthält, und alle gespeicherten Dateien werden gelöscht, und ihre Medien-URLs werden nicht mehr aufgelöst. Die Löschung ist endgültig und nicht rückgängig zu machen.Der Job meldet nur Zählwerte. Er listet nie auf, welche Sitzungen er gelöscht hat.## Jobstatus| `status` | Bedeutung | | - | - | | `PENDING` | Angenommen, noch nicht gestartet. | | `PROCESSING` | Wird gelöscht; `processed` und `outcomes` werden aktualisiert. | | `COMPLETED` | Jede ausgewählte Sitzung ist in `outcomes` erfasst. | | `FAILED` | Der Job wurde vorzeitig beendet, und `error` nennt den Grund. Die Sitzungen, die er nicht erreicht hat, sind weiterhin vorhanden: Wiederholen Sie die Löschanfrage, um sie zu löschen. |Ein `delete_all`-Job löscht nur die Sitzungen, die vor der Anfrage erstellt wurden. Sitzungen, die während seiner Laufzeit gestartet werden, werden nicht gelöscht.## Ergebniszähler| Schlüssel in `outcomes` | Bedeutung | | - | - | | `deleted` | Sitzungen, die zusammen mit ihrem Gesichts-Embedding gelöscht wurden. | | `none` | Gelöschte Sitzungen, die kein Gesichts-Embedding hatten. | | `retained_with_user` | Gelöschte Sitzungen, bei denen für ihren Benutzer ein bildfreies biometrisches Template beibehalten wurde, weil die Anfrage oder die Richtlinie der Anwendung dies verlangte. Siehe [Sitzung löschen](https://docs.didit.me/de/sessions-api/delete-session.md#biometrische-gesichtsdaten-löschen-oder-aufbewahren). | | `ineligible_no_vendor_user` | Die Beibehaltung wurde angefordert, aber der Sitzung war kein verknüpfter Benutzer zugeordnet. Die Sitzung und ihr Gesichts-Embedding wurden gelöscht. | | `failed_retryable` | Sitzungen, die als nicht gelöscht gemeldet wurden. Der Job wiederholt eine Gruppe, die er nicht selbst löschen konnte, statt sie hier zu zählen. | | `already_deleted` | Ausgewählte Sitzungen, die bereits gelöscht waren, etwa durch eine andere Anfrage, als der Job sie erreichte. |`deleted_child_verifications` zählt die Verifizierungen, die von gelöschten Unternehmensverifizierungen erstellt und zusammen mit diesen gelöscht wurden. Bei einem Job, der über [Mehrere Sitzungen löschen](https://docs.didit.me/de/management-api/sessions/batch-delete.md) gestartet wurde, ist der Wert immer `0`, da dieser Endpoint ausschließlich KYC-Sitzungen löscht.## BerechtigungenJeder aktive API-Schlüssel der Anwendung kann diesen Endpoint aufrufen. Ein Job ist nur für die Anwendung sichtbar, die ihn erstellt hat. Jede andere `job_id` liefert `404`.## Verwandte Themen- [Mehrere Sitzungen löschen](https://docs.didit.me/de/management-api/sessions/batch-delete.md) - [Sitzung löschen](https://docs.didit.me/de/sessions-api/delete-session.md) - [Datenaufbewahrung](https://docs.didit.me/de/console/data-retention.md) ## OpenAPI ````yaml de/openapi-25.json GET /v3/sessions/delete/{job_id}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/sessions/delete/{job_id}/: get: tags: - Sessions summary: Auftrag zur Massenlöschung von Sitzungen abrufen description: >- Fortschritt einer Massenlöschung von Sitzungen, die `POST /v3/sessions/delete/` mit `202` beantwortet hat (mehr als 20 übereinstimmende Sitzungen, ausgewählt über `session_numbers` oder mit `delete_all`). Alle paar Sekunden abfragen, solange der `status` `PENDING` oder `PROCESSING` ist; stoppen, wenn er `COMPLETED` oder `FAILED` lautet. Der Job meldet, wie viele Sitzungen mit welchem Ergebnis endeten und wie viele er verarbeitet hat, niemals jedoch, welche Sitzungen gelöscht wurden. Ein `FAILED`-Job enthält die Ursache in `error`; die Sitzungen, die er noch nicht erreicht hatte, sind weiterhin vorhanden. Wiederholen Sie daher die Löschanfrage, um diese zu löschen. **Authentifizierung:** API-Schlüssel im Header `x-api-key`. Ein Job ist nur für die Anwendung sichtbar, die ihn erstellt hat; jede andere `job_id` gibt `404` zurück. Fehlende oder ungültige Anmeldedaten geben `403` zurück; diese API gibt niemals `401` zurück. operationId: get_session_deletion_job parameters: - name: job_id in: path required: true schema: type: string format: uuid description: >- Die mit dem `202` von `POST /v3/sessions/delete/` zurückgegebene `job_id`. responses: '200': description: Der Job. 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: >- Fehlender API-Schlüssel. Ein fehlender Schlüssel führt zu einer `403`-Antwort; ein falscher, widerrufener oder abgelaufener Schlüssel führt zu einer `401`-Antwort. content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid API key: summary: >- Kein x-api-key-Header vorhanden oder der Schlüssel ist ungültig value: detail: You do not have permission to perform this action. '404': description: >- Für die aufrufende Anwendung existiert kein Löschauftrag mit dieser `job_id`. Aufträge sind nur für die Anwendung sichtbar, die sie erstellt hat. 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: >- Eine Massenlöschung von Sitzungen, die im Hintergrund ausgeführt wird: Fortschritt und Anzahlen pro Ergebnis, niemals welche Sitzungen gelöscht wurden. properties: job_id: type: string format: uuid description: >- Rufen Sie `GET /v3/sessions/delete/{job_id}/` mit dieser ID regelmäßig ab. status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED description: >- `PENDING`: Akzeptiert, noch nicht gestartet. `PROCESSING`: Wird gelöscht; `processed` und `outcomes` werden aktualisiert. `COMPLETED`: Jede ausgewählte Sitzung wurde berücksichtigt. `FAILED`: Der Auftrag wurde vorzeitig abgebrochen; siehe `error`. total: type: integer description: >- Sitzungen, die ausgewählt wurden, als die Löschung angefordert wurde. processed: type: integer description: Sitzungen, die der Job bisher abgeschlossen hat. outcomes: type: object description: >- Wie viele Sitzungen mit welchem Ergebnis geendet haben. Jeder Schlüssel ist immer vorhanden. properties: deleted: type: integer description: Zusammen mit ihrem Gesichts-Embedding gelöschte Sitzungen. none: type: integer description: Gelöschte Sitzungen, die kein Gesichts-Embedding hatten. retained_with_user: type: integer description: >- Gelöschte Sitzungen, bei denen ein bildfreies biometrisches Template für ihren Benutzer aufbewahrt wurde, wie von der Anfrage oder der Anwendungsrichtlinie gefordert. ineligible_no_vendor_user: type: integer description: >- Gelöschte Sitzungen samt ihrem Gesichts-Embedding, da eine Aufbewahrung angefordert wurde, sie jedoch keinen verknüpften Benutzer hatten. failed_retryable: type: integer description: >- Sitzungen, die als nicht gelöscht gemeldet wurden. Ein Job versucht, eine Gruppe, die er nicht selbst löschen konnte, erneut zu löschen, anstatt sie hier mitzuzählen. already_deleted: type: integer description: >- Ausgewählte Sitzungen, die bereits gelöscht waren, beispielsweise durch eine andere Anfrage, als der Job sie erreichte. deleted_child_verifications: type: integer description: >- Verifizierungen, die durch die gelöschten Unternehmensverifizierungen erstellt wurden und mit ihnen gelöscht werden. Immer `0` bei einem Job, der durch `POST /v3/sessions/delete/` gestartet wurde, da dieser nur KYC-Sitzungen löscht. error: type: string nullable: true description: >- `null`, außer wenn `status` auf `FAILED` steht; dann der Grund, warum die Löschung gestoppt wurde. Die Sitzungen, die der Job noch nicht erreicht hatte, bleiben bestehen: Wiederholen Sie die Anfrage, um sie zu löschen. created_at: type: string format: date-time description: Wann die Löschung angefordert wurde. completed_at: type: string format: date-time nullable: true description: Wann der Job beendet wurde; `null`, während er läuft. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.