企业股东接口

GET

平台接口企业

Markdown 文档

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

身份验证 API Key请求参数 5 项

请求地址示例

使用下方地址发起请求，支持一键复制。

GET

请求参数

根据传入位置，将参数放入 Query、Body 或 Header。

5 项参数

参数名	可传值说明	传入位置	是否必填	示例值	默认值	参数说明
`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

Authorization 请求头请登录后前往控制面板查询 API Key

请求示例

选择开发语言，复制示例并替换为实际参数。

Shell

curl --request GET 'https://api.brtl.cn/api/TYHolder?keyword=&pageSize=&pageNum=&source=' \
  --header 'Authorization: Bearer <access_key>'

返回示例

以下为接口配置的示例，实际内容以调用结果为准。

响应内容

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

参数名

可传值说明

传入位置

是否必填

示例值

默认值

参数说明

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

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