> ## 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. # Daftar Pihak KYB yang Diekstrak API > Baca pemegang saham, direktur, dan persentase kepemilikan yang tercantum dalam dokumen yang diunggah ke sesi KYB di Didit. ## OpenAPI ````yaml id/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 Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/kyb/extracted-parties/: get: tags: - Sessions summary: Daftar pihak yang disebutkan oleh dokumen yang diunggah description: >- Mengembalikan pemegang saham dan direktur yang disebutkan dalam dokumen yang diunggah ke sesi KYB ini, digabungkan per orang dan diatribusikan ke dokumen yang menyebutkannya. Tampilkan kepada pemohon Anda untuk dikonfirmasi, lalu deklarasikan dengan endpoint draf pihak. Rentang tetap berupa rentang: `ownership_percent.text` mempertahankan angka apa adanya dan `min` / `max` angka yang dibaca darinya. Tidak ada yang dilabeli sebagai UBO di sini; hal tersebut ditentukan saat pihak-pihak dikirimkan, berdasarkan pengaturan peran dan ambang batas kepemilikan pada alur kerja. Daftar yang sama ada dalam keputusan sesi sebagai `document_verifications[].extracted_parties`. Memerlukan `read:businesses` atau `read:sessions`. operationId: get_v3_session_kyb_extracted_parties parameters: - name: sessionId in: path required: true description: >- UUID dari sesi Verifikasi Bisnis (KYB). UUID ini harus dimiliki oleh aplikasi yang terkait dengan kunci API. schema: type: string format: uuid example: 33333333-4444-5555-6666-777777777777 - name: node_id in: query required: false description: >- Node alur kerja dari langkah KYB. Hanya diperlukan jika alur kerja memiliki lebih dari satu node KYB; secara default Didit menggunakan node milik sesi itu sendiri. schema: type: string responses: '200': description: Pihak yang disebutkan dalam dokumen saat ini. 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: >- Angka kepemilikan persis seperti yang tertera dalam dokumen, seperti `25-50%`, `>50%`, atau `NO EXHIBE`. min: type: number nullable: true description: >- Angka lebih rendah yang dibaca dari `text`; null jika tidak menyatakan apa pun. max: type: number nullable: true description: >- Angka atas yang dibaca dari `text`; null jika tidak menyatakan apa pun. documents: type: array description: Dokumen yang diunggah yang menyebutkan pihak ini. 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: >- Pemegang saham dan direktur yang disebutkan dalam dokumen yang diunggah, digabungkan per orang. Tidak ada yang dilabeli sebagai UBO di sini: hal tersebut diputuskan ketika para pihak diajukan. document_count: type: integer description: >- Jumlah dokumen yang diunggah yang menjadi sumber daftar tersebut. 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: >- Kunci API dengan cakupan terbatas telah kedaluwarsa. Ini satu-satunya kasus yang mengembalikan `401`: kunci yang hilang, tidak valid, atau dicabut mengembalikan `403`. content: application/json: schema: type: object properties: detail: type: string description: Pesan kesalahan yang mudah dibaca manusia. examples: Expired key: summary: Tanggal kedaluwarsa kunci telah lewat value: detail: This API key has expired. '403': description: >- Kegagalan autentikasi atau otorisasi. Kunci yang hilang mengembalikan `403`, begitu juga dengan kunci dari aplikasi lain, kunci dengan cakupan tanpa izin yang dibutuhkan endpoint ini, dan permintaan dari luar daftar izin IP kunci tersebut; kunci yang salah, dicabut, atau kedaluwarsa mengembalikan `401`. Bedakan kegagalan tersebut berdasarkan `detail`. content: application/json: schema: type: object properties: detail: type: string description: Pesan kesalahan yang mudah dibaca manusia. examples: Missing or invalid credentials: summary: Tidak ada header x-api-key, atau kunci gagal divalidasi value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: Kunci valid milik aplikasi yang berbeda dari sesi value: detail: You do not have permission to perform this action. Scoped key without decisions write: summary: 'Kunci ber-scope tidak memiliki decisions: write' value: detail: This API key has no write access to decisions. IP not allowed: summary: Permintaan dari luar daftar izin IP kunci value: detail: This API key can't be used from this IP address. '404': description: >- Sesi tidak ada, telah dihapus, milik aplikasi lain, atau berada di luar batas kunci dengan cakupan terbatas; tidak ada detail yang membedakannya. content: application/json: schema: type: object properties: detail: type: string description: Pesan kesalahan yang mudah dibaca manusia. 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: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.