> ## 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 में बल्क सत्र हटाने के जॉब की स्थिति और परिणाम गिनती प्राप्त करें, जब 20 से अधिक सत्र मेल खाने पर बैच डिलीट सत्र ने 202 लौटाया। सत्र हटाने के जॉब का प्रॉम्प्ट प्राप्त करें प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

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

\
यहाँ पेस्ट करें ## अवलोकनयह एक बल्क सत्र हटाने का जॉब लौटाता है, जिसे [Batch Delete Sessions](https://docs.didit.me/hi/management-api/sessions/batch-delete.md) से शुरू किया गया था: इसकी स्थिति, कितने सत्र संसाधित हुए, और प्रत्येक परिणाम में कितने सत्र आए।जब `session_numbers` से चुने गए या `delete_all` के साथ बैच हटाने में 20 से अधिक KYC सत्र मेल खाते हैं, तो अनुरोध `PENDING` जॉब के साथ `202` लौटाता है और सत्र पृष्ठभूमि में हटाए जाते हैं। जब तक `status` `COMPLETED` या `FAILED` न हो जाए, इस endpoint को हर कुछ सेकंड में पोल करें।जॉब द्वारा हटाया जाने वाला प्रत्येक सत्र उसी तरह हटाया जाता है जैसे [Delete Session](https://docs.didit.me/hi/sessions-api/delete-session.md) से हटाया जाता है: सत्र, उसके पास मौजूद हर सत्यापन प्रयास और उसकी संग्रहीत सभी फ़ाइलें हटा दी जाती हैं, और उसके मीडिया URL काम करना बंद कर देते हैं। हटाना स्थायी है और इसे पलटा नहीं जा सकता।जॉब केवल गिनती की रिपोर्ट देता है। यह कभी नहीं बताता कि उसने कौन से सत्र हटाए।## जॉब की स्थिति| `status` | अर्थ | | - | - | | `PENDING` | स्वीकार किया गया, अभी शुरू नहीं हुआ। | | `PROCESSING` | हटाया जा रहा है; `processed` और `outcomes` अपडेट हो रहे हैं। | | `COMPLETED` | चुने गए हर सत्र का हिसाब `outcomes` में है। | | `FAILED` | जॉब जल्दी रुक गया और `error` बताता है कि क्यों। जिन सत्रों तक वह नहीं पहुँचा, वे अभी भी मौजूद हैं: उन्हें हटाने के लिए हटाने का अनुरोध दोबारा भेजें। |`delete_all` जॉब केवल वे सत्र हटाता है जो अनुरोध से पहले बनाए गए थे। जॉब चलने के दौरान शुरू हुए सत्र नहीं हटाए जाते।## परिणामों की गिनती| `outcomes` कुंजी | अर्थ | | - | - | | `deleted` | सत्र उनके फ़ेस एम्बेडिंग के साथ हटाए गए। | | `none` | वे सत्र हटाए गए जिनमें कोई फ़ेस एम्बेडिंग नहीं था। | | `retained_with_user` | सत्र हटाए गए, जबकि अनुरोध या एप्लिकेशन नीति के अनुसार उनके उपयोगकर्ता के लिए एक बिना इमेज वाला बायोमेट्रिक टेम्पलेट रखा गया। देखें [Delete Session](https://docs.didit.me/hi/sessions-api/delete-session.md#फ़ेस-बायोमेट्रिक-डेटा-हटाना-या-रखना)। | | `ineligible_no_vendor_user` | प्रतिधारण का अनुरोध किया गया था, लेकिन सत्र से कोई उपयोगकर्ता जुड़ा नहीं था। सत्र और उसका फ़ेस एम्बेडिंग हटा दिए गए। | | `failed_retryable` | वे सत्र जिनके हटाए न जाने की रिपोर्ट की गई है। जो समूह जॉब खुद नहीं हटा पाया, जॉब उसे यहाँ गिनने के बजाय दोबारा प्रयास करता है। | | `already_deleted` | चुने गए वे सत्र जो पहले ही हटाए जा चुके थे, उदाहरण के लिए किसी दूसरे अनुरोध से, जब जॉब उन तक पहुँचा। |`deleted_child_verifications` उन सत्यापनों को गिनता है जो व्यवसाय सत्यापन ने बनाए थे और जिन्हें उनके साथ हटाया गया। यह [Batch Delete Sessions](https://docs.didit.me/hi/management-api/sessions/batch-delete.md) से शुरू किए गए जॉब के लिए हमेशा `0` रहता है, क्योंकि वह केवल KYC सत्र हटाता है।## अनुमतियाँएप्लिकेशन की कोई भी सक्रिय API कुंजी इस endpoint को कॉल कर सकती है। जॉब केवल उसी एप्लिकेशन को दिखता है जिसने उसे बनाया है; कोई भी अन्य `job_id` `404` लौटाता है।## संबंधित- [Batch Delete Sessions](https://docs.didit.me/hi/management-api/sessions/batch-delete.md) - [Delete Session](https://docs.didit.me/hi/sessions-api/delete-session.md) - [Data retention](https://docs.didit.me/hi/console/data-retention.md) ## OpenAPI ````yaml hi/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` के साथ उत्तर दिया था (`session_numbers` द्वारा या `delete_all` के साथ चुने गए 20 से अधिक मिलान वाले सत्र)। जब `status` `PENDING` या `PROCESSING` हो, तो हर कुछ सेकंड में पोल करें; जब यह `COMPLETED` या `FAILED` हो जाए तो रुकें। जॉब यह रिपोर्ट करता है कि प्रत्येक परिणाम में कितने सत्र समाप्त हुए और इसने कितनों को संसाधित किया है, यह कभी नहीं बताता कि इसने किन सत्रों को हटाया है। एक `FAILED` जॉब `error` में कारण बताती है; जिन सत्रों तक यह नहीं पहुंची थी वे अभी भी बने हुए हैं, इसलिए उन्हें हटाने के लिए विलोपन अनुरोध को दोहराएं। **प्रमाणीकरण:** `x-api-key` हेडर में API कुंजी। एक जॉब केवल उसी एप्लिकेशन को दिखाई देती है जिसने इसे बनाया है; कोई अन्य `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: '`POST /v3/sessions/delete/` से `202` के साथ लौटाया गया `job_id`।' 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: इस id के साथ `GET /v3/sessions/delete/{job_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: >- हटाए गए व्यवसाय सत्यापनों द्वारा बनाए गए वे सत्यापन, जिन्हें उनके साथ ही हटा दिया गया है। `POST /v3/sessions/delete/` द्वारा शुरू किए गए जॉब के लिए हमेशा `0`, जो केवल KYC सत्रों को हटाता है। error: type: string nullable: true description: >- जब तक `status`, `FAILED` न हो, तब तक `null`; यदि ऐसा है, तो विलोपन रुकने का कारण। जिन सत्रों तक कार्य नहीं पहुँचा था, वे अभी भी मौजूद हैं: उन्हें हटाने के लिए अनुरोध पुनः दोहराएँ। 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 कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys। ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.