> ## 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 > KYB 세션에 업로드된 문서에 기재된 주주, 이사, 지분율을 Didit API로 조회합니다. ## OpenAPI ````yaml ko/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 세션에 업로드된 문서에 명시된 주주와 이사를 개인별로 병합하고 해당 인물을 명시한 문서에 귀속시켜 반환합니다. 신청자에게 표시하여 확인받은 후 party 초안 endpoint를 사용하여 신고하십시오. 범위는 범위로 유지됩니다: `ownership_percent.text`에는 원문 수치가 유지되고 `min` / `max`에는 이로부터 읽은 숫자가 유지됩니다. 여기서는 아무도 UBO로 지정되지 않으며, party가 제출될 때 워크플로의 역할 설정 및 소유 구조 임계값에 따라 결정됩니다. 동일한 목록이 세션 결정에 `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`에서 읽어낸 더 작은 숫자입니다. 명시된 것이 없으면 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 허용 목록 외부에서 보낸 요청의 경우에도 마찬가지입니다. 잘못되었거나 취소되었거나 만료된 키는 `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: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 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.