## 最终受益人信息查询接口（新）
----

本接口用于查询最终受益人信息

### 调用路径
>   http://api.shuidi.cn/open/ultimate/beneficiary

### 输入参数

|参数名称 | 是否必填 | 说明 |
| -------- | -------- | -------- |
|认证相关参数 | 是| 见接口认证章节说明 |
|key | 是 | 查询公司名称/注册号/统一社会信用代码 |

{% include '../common/authenticate.md' %}

### 输出结果

{% include '../common/output_format.md' %}

#### 输出样例
```json
{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {
        "result": {
            "companyName": "小米科技有限责任公司",
            "names": [
                {
                    "name": "雷军",
                    "percentTotal": "77.80%",
                    "paths": [
                        [
                            {
                                "name": "雷军",
                                "percentTotal": "77.80%",
                                "percent": "77.80%",
                                "level": "1"
                            }
                        ]
                    ]
                }
            ]
        }
    }
}

```
#### 输出结果字段含义

| 属性名 | 含义 |
| -------- | -------- |
| companyName | 公司名称 |
| names.name | 最终受益人名称 |
| names.percentTotal | 最终受益人总持股比例 |
| names.paths.name | 名称 |
| names.paths.percentTotal | 总持股比例 |
| names.paths.percent | 持股比例 |
| names.paths.level | 股权链等级 |


{% include '../common/error_code.md'%}