> ## 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. # KYB निकाले गए पक्षकार सूची API > Didit के KYB सत्र में अपलोड दस्तावेज़ों से निकाले गए शेयरधारक, निदेशक और स्वामित्व प्रतिशत पढ़ें। ## OpenAPI ````yaml hi/openapi-25.json GET /v3/session/{sessionId}/kyb/extracted-parties/ 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/session/{sessionId}/kyb/extracted-parties/: get: tags: - Sessions summary: अपलोड किए गए दस्तावेज़ों द्वारा नामित पक्षों की सूची बनाएं description: >- इस KYB सत्र में अपलोड किए गए दस्तावेज़ों में नामित शेयरधारकों और निदेशकों को लौटाएँ, जिन्हें प्रति व्यक्ति मर्ज किया गया है और उन दस्तावेज़ों से संबद्ध किया गया है जिनमें उनका नाम है। पुष्टि करने के लिए उन्हें अपने आवेदक को दिखाएँ, फिर पार्टी ड्राफ़्ट endpoints के साथ उन्हें घोषित करें। एक रेंज रेंज ही रहती है: `ownership_percent.text` मूल, शब्दशः लिखे गए आंकड़े को बनाए रखता है और `min` / `max` उससे पढ़े गए नंबरों को बनाए रखते हैं। यहाँ किसी को भी UBO के रूप में लेबल नहीं किया गया है; यह तब तय किया जाता है जब पार्टियों को सबमिट किया जाता है, वर्कफ़्लो की भूमिका सेटिंग्स और स्वामित्व थ्रेशोल्ड से। यही सूची सत्र निर्णय में `document_verifications[].extracted_parties` के रूप में होती है। इसके लिए `read:businesses` या `read:sessions` की आवश्यकता होती है। operationId: get_v3_session_kyb_extracted_parties parameters: - name: sessionId in: path required: true description: >- व्यवसाय सत्यापन (KYB) सत्र का UUID। यह API कुंजी के एप्लिकेशन से संबंधित होना चाहिए। schema: type: string format: uuid example: 33333333-4444-5555-6666-777777777777 - name: node_id in: query required: false description: >- KYB चरण का वर्कफ़्लो नोड। केवल तभी आवश्यक जब वर्कफ़्लो में एक से अधिक KYB नोड हों; डिफ़ॉल्ट रूप से Didit सत्र के अपने नोड का उपयोग करता है। schema: type: string responses: '200': description: वर्तमान दस्तावेज़ों द्वारा नामित पक्ष। content: application/json: schema: type: object required: - parties - document_count properties: parties: type: array items: type: object properties: name: type: string entity_type: type: string enum: - person - company first_name: type: string nullable: true last_name: type: string nullable: true appointment_date: type: string nullable: true designation: type: string nullable: true roles: type: array items: type: object properties: role: type: string enum: - director - non_executive_director - secretary - chairman - ubo - shareholder - representative - founder - legal_advisor - authorized_signatory - trustee - beneficiary - settlor - protector - company_officer - investor - other ownership_percent: type: object properties: text: type: string nullable: true description: >- स्वामित्व का आंकड़ा ठीक वैसा ही जैसा दस्तावेज़ में बताया गया है, जैसे कि `25-50%`, `>50%` या `NO EXHIBE`। min: type: number nullable: true description: >- `text` से पढ़ी गई निचली संख्या; जब इसमें none लिखा हो तो null। max: type: number nullable: true description: >- `text` से पढ़ी गई ऊपरी संख्या; जब कोई संख्या न हो तो null। documents: type: array description: अपलोड किए गए दस्तावेज़ जिनमें इस पक्ष का नाम था। items: type: object properties: document_uuid: type: string format: uuid document_type: type: string nullable: true document_subtype: type: string nullable: true original_filename: type: string nullable: true status: type: string nullable: true description: >- अपलोड किए गए दस्तावेज़ों में उल्लिखित शेयरधारक और निदेशक, प्रति व्यक्ति मर्ज किए गए। यहाँ किसी को भी UBO के रूप में लेबल नहीं किया जाता है: यह पार्टियों के सबमिट होने पर तय किया जाता है। document_count: type: integer description: अपलोड किए गए दस्तावेज़ों की संख्या जिनसे सूची पढ़ी गई थी। node_id: type: string nullable: true example: parties: - name: Ana Lopez entity_type: person first_name: Ana last_name: Lopez appointment_date: null designation: Administrador unico roles: - role: shareholder ownership_percent: text: 60% min: 60 max: 60 documents: - document_uuid: 0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41 document_type: OWNERSHIP_STRUCTURE document_subtype: ARTICLES_OF_INCORPORATION original_filename: acta_constitutiva.pdf status: Approved document_count: 1 node_id: node_kyb_documents '401': description: >- स्कोप्ड API कुंजी की समय-सीमा समाप्त हो गई है। यह एकमात्र मामला है जो `401` लौटाता है: अनुपलब्ध, अमान्य या निरस्त कुंजी `403` लौटाती है। content: application/json: schema: type: object properties: detail: type: string description: मानव-पठनीय त्रुटि संदेश। examples: Expired key: summary: कुंजी की समाप्ति तिथि बीत चुकी है value: detail: This API key has expired. '403': description: >- प्रमाणीकरण या प्राधिकरण विफलता। अनुपस्थित कुंजी `403` लौटाती है, और किसी अन्य एप्लिकेशन की कुंजी, इस endpoint के लिए आवश्यक अनुमति के बिना वाली स्कोप्ड कुंजी, तथा कुंजी की IP अनुमति सूची (allowlist) के बाहर से किया गया अनुरोध भी यही लौटाता है; गलत, निरस्त या समय-सीमा समाप्त कुंजी `401` लौटाती है। उन्हें `detail` द्वारा पहचानें। content: application/json: schema: type: object properties: detail: type: string description: मानव-पठनीय त्रुटि संदेश। examples: Missing or invalid credentials: summary: कोई x-api-key हेडर नहीं है, या कुंजी सत्यापन में विफल रही value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: एक मान्य कुंजी जो सत्र से भिन्न एप्लिकेशन से संबंधित है value: detail: You do not have permission to perform this action. Scoped key without decisions write: summary: 'स्कोप्ड कुंजी में decisions: write की कमी है' value: detail: This API key has no write access to decisions. IP not allowed: summary: कुंजी की IP अनुमति सूची से बाहर का अनुरोध value: detail: This API key can't be used from this IP address. '404': description: >- सत्र मौजूद नहीं है, हटा दिया गया था, किसी अन्य एप्लिकेशन से संबंधित है या स्कोप्ड कुंजी की सीमाओं से बाहर है; कोई विवरण उनमें अंतर नहीं करता है। content: application/json: schema: type: object properties: detail: type: string description: मानव-पठनीय त्रुटि संदेश। example: detail: Session not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.list_kyb_extracted_parties( "33333333-4444-5555-6666-777777777777", ) 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.listKybExtractedParties("33333333-4444-5555-6666-777777777777"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.ListKYBExtractedParties(ctx, \"33333333-4444-5555-6666-777777777777\", didit.SessionsListKYBExtractedPartiesParams{})\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().listKybExtractedParties("33333333-4444-5555-6666-777777777777"); System.out.println(result); - lang: php label: PHP source: >- sessions->listKybExtractedParties('33333333-4444-5555-6666-777777777777'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.list_kyb_extracted_parties("33333333-4444-5555-6666-777777777777") 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.ListKybExtractedPartiesAsync("33333333-4444-5555-6666-777777777777"); 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.