# 企业股东接口

**请求方式：** GET

**接口地址：** https://v2.xxapi.cn/api/TYHolder

**接口描述：** 可以通过公司名称或ID获取企业股东信息，股东信息包括股东名、出资比例、出资金额、股东总数等字段的详细信息

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| keyword | string | query | 必传 | — | — | 搜索关键字（公司名称、公司id、注册号或社会统一信用代码） |
| pageSize | number | query | 可选 | — | — | 每页条数（默认20条，最大20条） |
| pageNum | number | query | 可选 | — | — | 当前页数（默认第1页） |
| source | 1 \|\| 2 | query | 可选 | — | — | 数据来源：枚举：1-工商登记、2-最新公示，非必填。不填默认为【工商登记】 |
| Authorization | Bearer <access_key> | header | 必传 | Bearer <access_key> | — | 请登录后前往控制面板查询 API Key |

## 返回示例

```json
{
    "code": 200, 
    "msg": "数据请求成功", 
    "data": {
        "items": [
            {
                "id": 1923977966, // ID
                "cgid": null, // 公司ID
                "hcgid": "1923977966-c7556013708", // 股权关系ID

                "name": "张子阳", // 股东名称
                "alias": "张", // 简称

                "type": 2, // 股东类型：1-公司 2-自然人 3-其它

                "ftShareholding": 0, 
                // 首次持股时间（时间戳，0表示暂无数据）

                "capital": [
                    {
                        "amomon": "300万元人民币", // 认缴出资金额
                        "paymet": "货币", // 出资方式（货币/实物等）
                        "percent": "100%", // 出资占比
                        "time": "2030-05-15" // 认缴时间
                    }
                ],

                "capitalActl": [
                    // 实缴出资（当前为空，表示未实缴）
                    // 示例：
                    // {
                    //   "amomon": "100万元人民币",
                    //   "paymet": "货币",
                    //   "percent": "30%",
                    //   "time": "2024-01-01"
                    // }
                ],

                "hkCapital": {
                    "percent": "", // 香港持股占比
                    "quantity": "" // 香港持股数量
                }
            }
        ],
        "total": 1 // 股东总数
    },
    "request_id": "d4b1b8e26028350d85271ca9"
}
```