列出 KYB 提取相关方 API

Python

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.sessions.list_kyb_extracted_parties(
    "33333333-4444-5555-6666-777777777777",
)
print(result)

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);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Sessions.ListKYBExtractedParties(ctx, "33333333-4444-5555-6666-777777777777", didit.SessionsListKYBExtractedPartiesParams{})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

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);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->sessions->listKybExtractedParties('33333333-4444-5555-6666-777777777777');
print_r($result->toArray());

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));

{
  "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"
}

GET

session

{sessionId}

kyb

extracted-parties

Python

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.sessions.list_kyb_extracted_parties(
    "33333333-4444-5555-6666-777777777777",
)
print(result)

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);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Sessions.ListKYBExtractedParties(ctx, "33333333-4444-5555-6666-777777777777", didit.SessionsListKYBExtractedPartiesParams{})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

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);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->sessions->listKybExtractedParties('33333333-4444-5555-6666-777777777777');
print_r($result->toArray());

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));

{
  "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"
}

授权

x-api-key

string

header

必填

您的应用 API 密钥，可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域：针对每个资源设为无权限、只读或读写，限定于特定工作流或已通过的会话、限定于 IP 地址列表，以及设置到期日期。401 表示密钥错误、已撤销或已过期；403 表示未发送密钥、密钥无权访问该资源或操作，或请求来自其 IP 列表之外的地址；在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null；没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

sessionId

string<uuid>

必填

企业验证（KYB）会话的 UUID。它必须属于 API 密钥所属的应用。

示例:

"33333333-4444-5555-6666-777777777777"

查询参数

node_id

string

KYB 步骤的工作流节点。仅在工作流具有多个 KYB 节点时需要；默认情况下，Didit 会使用会话自身的节点。

响应

当前证件中注明的当事方。

parties

object[]

必填

上传证件中提及的股东和董事，按人合并。此处不会将任何人标记为 UBO：该标记在提交各方信息时确定。

Show child attributes

document_count

integer

必填

读取该列表所来源的已上传证件数量。

node_id

string | null

最后修改于 2026年11月7日