> ## 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 से एक संरक्षित चेहरा बायोमेट्रिक टेम्पलेट का विवरण प्राप्त करें: उपयोगकर्ता, स्रोत, समाप्ति तिथि और स्थिति। GET /v3/biometric-templates/{template_uuid}/ Returns one template. Use the `biometric_template_uuid` returned by [Delete Session](https://docs.didit.me/hi/sessions-api/delete-session.md), the `biometric_template_id` on a [चेहरा खोज का मिलान](https://docs.didit.me/hi/core-technology/face-search/report-face-search.md), or an ID from the [सूची](https://docs.didit.me/hi/management-api/biometric-templates/list.md). ```bash theme={null} curl -X GET https://verification.didit.me/v3/biometric-templates/9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b/ \ -H "x-api-key: YOUR_API_KEY" ``` ```json theme={null} { "uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b", "vendor_user_uuid": "2f7c1a9e-8b4d-4c6a-9e1f-3d5b7a9c1e2f", "vendor_data": "user-42", "source_type": "session_delete", "provenance_reference": "6b1e8d2f-4a3c-4f9e-8c7d-1a2b3c4d5e6f", "retention_policy": "retain_until_user_deleted", "retention_override": null, "retained_at": "2026-08-28T10:15:42.318402Z", "expires_at": "2027-08-28T10:15:42.318402Z", "retained_by": "3c9e2b1f-7d4a-4e8b-9c1d-5f6a7b8c9d0e", "retained_by_type": "API_KEY", "instruction_class": "operational_session_delete", "instruction_source": "api", "instruction_id": "post-approval-cleanup-2026-08", "held_out_of_use": false, "status": "active", "purged_at": null } ``` रिस्पॉन्स में कभी कोई इमेज, वेक्टर, हटाए गए सत्र की ID, या पहचान डेटा शामिल नहीं होता। हर फ़ील्ड के लिए [अवलोकन](https://docs.didit.me/hi/management-api/biometric-templates/overview.md#टेम्पलेट-ऑब्जेक्ट) देखें। ## त्रुटियाँ | स्थिति | कब | बॉडी | | - | - | - | | `403` | कंसोल उपयोगकर्ता token, या API कुंजी की अनुमति नहीं है | `{"detail": "You do not have permission to perform this action."}` | | `404` | अज्ञात टेम्पलेट, किसी अन्य एप्लिकेशन का टेम्पलेट, या पर्ज़ किया गया टेम्पलेट | `{"detail": "Biometric template not found."}` | ## OpenAPI ````yaml hi/openapi-25.json GET /v3/biometric-templates/{template_uuid}/ 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/biometric-templates/{template_uuid}/: get: tags: - Biometric Templates summary: प्रतिधारित बायोमेट्रिक टेम्पलेट प्राप्त करें description: >- एक ऑप्ट-इन एप्लिकेशन सत्र हटाए जाने पर उपयोगकर्ता से जुड़े एक अलग से प्रबंधित, छवि-मुक्त फ़ेस बायोमेट्रिक टेम्पलेट को रखता है (`DELETE /v3/session/{sessionId}/delete/` देखें)। टेम्पलेट बायोमेट्रिक डेटा होते हैं, जिनका `expires_at` सीमित होता है; उनमें कभी भी छवियां, सत्र डेटा या पहचान फ़ील्ड नहीं होते हैं, और उन्हें उपयोगकर्ता हटाए जाने, गोपनीयता मिटाने, समय-सीमा समाप्त होने या स्पष्ट पर्ज पर पर्ज कर दिया जाता है। ये endpoint केवल एप्लिकेशन API कुंजी (`x-api-key`) स्वीकार करते हैं; Business Console उपयोगकर्ता टोकन को `403` के साथ अस्वीकार कर दिया जाता है। एक टेम्पलेट लौटाता है। रिस्पॉन्स में कभी भी कोई छवि, वेक्टर, हटाए गए सत्र की id या पहचान डेटा शामिल नहीं होता है। operationId: get_biometric_template parameters: - in: path name: template_uuid required: true description: >- टेम्पलेट id, जैसा कि सत्र हटाने वाले endpoints द्वारा `biometric_template_uuid` में, चेहरा खोज मिलान पर `biometric_template_id` में, या सूची endpoint द्वारा लौटाया जाता है। schema: type: string format: uuid example: 9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b responses: '200': description: टेम्पलेट। content: application/json: schema: type: object properties: uuid: type: string format: uuid description: >- टेम्पलेट id। रैंडम रूप से जनरेट किया गया; हटाए गए सत्र या उसके चेहरे से व्युत्पन्न नहीं। vendor_user_uuid: type: string format: uuid description: स्वामित्व वाला उपयोगकर्ता। vendor_data: type: string nullable: true description: >- उपयोगकर्ता का वर्तमान `vendor_data`, जो तब रिज़ॉल्व होता है जब आप टेम्पलेट पढ़ते हैं (कभी कॉपी नहीं किया जाता)। source_type: type: string enum: - session_delete - automatic_retention - backfill description: >- टेम्पलेट कैसे बनाया गया था: सत्र विलोपन (API या Console), एप्लिकेशन की स्वचालित डेटा प्रतिधारण विंडो, या आपके द्वारा निर्देशित Didit-संचालित बैकफ़िल। provenance_reference: type: string format: uuid description: >- टेम्पलेट को उसके ऑडिट लॉग से जोड़ने वाला अपारदर्शी संदर्भ। यह हटाए गए सत्र की ID नहीं है और इसे उस सत्र की ID में resolve नहीं किया जा सकता है। retention_policy: type: string enum: - delete_with_session - retain_until_user_deleted description: प्रतिधारण समय पर एप्लिकेशन नीति। retention_override: type: boolean nullable: true description: >- विलोपन पर भेजा गया `retain_face_embeddings` मान, या नीति लागू होने पर `null`। retained_at: type: string format: date-time expires_at: type: string format: date-time description: >- टेम्पलेट कब समाप्त होता है और स्वचालित रूप से हटा दिया जाता है। हमेशा सेट रहता है। retained_by: type: string nullable: true description: >- निर्देश देने वाला प्रिंसिपल: API कुंजियों के लिए एप्लिकेशन आईडी, कंसोल कार्रवाइयों के लिए कंसोल सदस्य आईडी, या स्वचालित प्रतिधारण के लिए एक `service:` पहचानकर्ता। कभी भी ईमेल पता नहीं। retained_by_type: type: string enum: - API_KEY - CONSOLE_USER - SYSTEM instruction_class: type: string enum: - operational_session_delete - privacy_erasure instruction_source: type: string enum: - api - console - automatic_retention - backfill - privacy_erasure - explicit_template_purge - vendor_user_delete - expiry - reconciliation - migration - system instruction_id: type: string description: >- विलोपन पर भेजा गया `instruction_id`, या Didit द्वारा जनरेट किया गया id। held_out_of_use: type: boolean description: >- `true` केवल तभी जब कानूनी रोक लागू हो। रोके गए टेम्पलेट को सभी मिलानों से बाहर रखा जाता है। status: type: string enum: - pending - active - expired - held_out_of_use - purge_pending - purge_failed - purged description: >- केवल `active` टेम्पलेट जो होल्ड पर नहीं हैं, जिनकी `expires_at` समाप्त नहीं हुई है, और जिनका उपयोगकर्ता अभी भी मौजूद है, मिलान में भाग लेते हैं। purged_at: type: string format: date-time nullable: true examples: Active template: value: uuid: 9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b vendor_user_uuid: 2f7c1a9e-8b4d-4c6a-9e1f-3d5b7a9c1e2f vendor_data: user-42 source_type: session_delete provenance_reference: 6b1e8d2f-4a3c-4f9e-8c7d-1a2b3c4d5e6f retention_policy: retain_until_user_deleted retention_override: null retained_at: '2026-08-28T10:15:42.318402Z' expires_at: '2027-08-28T10:15:42.318402Z' retained_by: 3c9e2b1f-7d4a-4e8b-9c1d-5f6a7b8c9d0e retained_by_type: API_KEY instruction_class: operational_session_delete instruction_source: api instruction_id: post-approval-cleanup-2026-08 held_out_of_use: false status: active purged_at: null '403': description: >- कंसोल उपयोगकर्ता token, या API कुंजी की अनुमति नहीं है। ये endpoints केवल एप्लिकेशन API कुंजियों को स्वीकार करते हैं। content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: >- अज्ञात टेम्पलेट, किसी अन्य एप्लिकेशन का टेम्पलेट, या (`GET` पर) हटा दिया गया टेम्पलेट। content: application/json: examples: Not found: value: detail: Biometric template not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET https://verification.didit.me/v3/biometric-templates/9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b/ \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.biometric_templates.retrieve( "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b", ) 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.biometricTemplates.retrieve("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.BiometricTemplates.Retrieve(ctx, \"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b\")\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.biometricTemplates().retrieve("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"); System.out.println(result); - lang: php label: PHP source: >- biometricTemplates->retrieve('9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.biometric_templates.retrieve("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b") 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.BiometricTemplates.RetrieveAsync("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"); Console.WriteLine(JsonSerializer.Serialize(result)); components: 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.