get
https://sandboxapi.legendtrading.com/v2/app/kyc/entity/bo/list
该接口用于获取企业KYB流程中已添加的实际受益人(Beneficial Owners)列表信息。实际受益人是指直接或间接持有企业一定比例股份或拥有最终控制权的自然人。返回的数据包含受益人的个人信息、持股比例、职位信息以及相关身份证明文件等,用于满足反洗钱(AML)和了解你的客户(KYC)合规要求。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | string | 是 | 用户ID,用于标识当前操作的企业用户,如:123 或 {{uid}} |
返回参数说明
响应结构
| 字段名 | 类型 | 说明 |
|---|---|---|
| request_id | string | 请求唯一标识ID,用于追踪和排查问题 |
| status | string | 响应状态,success表示成功 |
| code | string | 响应状态码,100000表示成功 |
| message | string | 响应消息说明 |
| metadata | object | 元数据信息 |
| data | array | 实际受益人信息列表,每个元素为一个受益人的详细信息 |
data数组结构 - 受益人对象字段说明
基本信息
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | string | 受益人唯一标识ID |
| first_name | string | 名 |
| middle_name | string | 中间名(可选) |
| last_name | string | 姓 |
