> For the complete documentation index, see [llms.txt](https://docs.elven.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elven.com/v3/chinese/openapi/v3/zhang-hu-cha-xun-jie-kou.md).

# 账户查询接口

### 接口概述

该接口用于查询系统中的账户列表，支持分页查询。

* **请求方式**：`GET`
* **请求URL**：`https://openapi.elven.com/open/v3/entityAccount`

### 请求头参数

<table><thead><tr><th width="202">参数名</th><th width="90">类型</th><th width="64">必填</th><th>说明</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>是</td><td>分配给您的API密钥</td></tr><tr><td>elven-api-sign</td><td>String</td><td>是</td><td>请求签名，用于验证请求合法性</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>是</td><td>请求时间戳，毫秒级</td></tr></tbody></table>

[查看详细说明](https://docs.elven.com/v3/openapi/jie-kou-shou-quan#elven-api-sign)

### 请求参数

#### Query 参数

<table><thead><tr><th width="109">参数名</th><th width="119">类型</th><th width="96">必填</th><th>说明</th></tr></thead><tbody><tr><td>page</td><td>Number</td><td>否</td><td>页码，为空视为1</td></tr><tr><td>limit</td><td>Number</td><td>否</td><td>每页条数，为空视为10</td></tr></tbody></table>

#### 请求示例

```bash
GET https://openapi.elven.com/open/v3/entityAccount?page=1&limit=10
```

### 响应参数

<table><thead><tr><th width="183">参数名</th><th width="111">类型</th><th>说明</th></tr></thead><tbody><tr><td>total</td><td>Number</td><td>结果数量</td></tr><tr><td>list</td><td>Array</td><td>账户列表</td></tr></tbody></table>

#### list 数组元素

<table><thead><tr><th width="183">参数名</th><th width="112">类型</th><th>说明</th></tr></thead><tbody><tr><td>entityAccountId</td><td>String</td><td>账户的主键ID</td></tr><tr><td>name</td><td>String</td><td>账户名称</td></tr><tr><td>platformId</td><td>String</td><td>平台主键ID</td></tr><tr><td>identity</td><td>String</td><td>账户地址</td></tr><tr><td>memo</td><td>String</td><td>备注信息</td></tr><tr><td>auxiliaryValueList</td><td>Array</td><td><p>账户辅助核算字段信息<br><code>auxiliaryTypeName</code>：辅助核算字段名称</p><p><code>auxiliaryTypeId</code>：辅助核算字段的值</p><p></p><p><code>auxiliaryItemValue</code>：如果当前辅助核算是文本类型的辅助核算字段，会返回对应文本选项内容<br><code>auxiliaryTypeId</code>：如果当前辅助核算是文本类型的辅助核算字段，会返回对应文本选项的 id</p><p><br><code>counterpartyName</code>：如果当前辅助核算是对手方类型的辅助核算字段，会返回对应对手方的名称<br><code>counterpartyId</code>：如果当前辅助核算是对手方类型的辅助核算字段，会返回对应对手方id<br></p></td></tr></tbody></table>

#### 响应示例

```json
{
    "total": 100,
    "list": [
        {
            "entityAccountId": "xxxx",
            "name": "account1",
            "platformId": "xxx",
            "identity": "xxx",
             "auxiliaryValueList": [
                    {
                        "auxiliaryTypeName": "Counterparty",
                        "counterpartyName": "customer01",
                        "counterpartyId": "MHVuIUrKPrUuVB0e519dH8SbTa3N4jDC",
                        "auxiliaryTypeId": "xs4NuYCtH9nPdmiXOCl8qZbFDJ1B6SWY"
                    },
                    {
                        "auxiliaryTypeName": "BU",
                        "auxiliaryItemValue": "BU1",
                        "auxiliaryItemId": "oKSGm0VqRNP0WdT1B7IRYCwryjhFtfi9",
                        "auxiliaryTypeId": "9eCjkxpGkOuhc8QewtTI1Cm0qsA3aVn5"
                    }
                ],
            "memo": ""
        },
        {
            "entityAccountId": "yyyy",
            "name": "account2",
            "platformId": "yyy",
            "identity": "yyy",
            "memo": "这是第二个账户"
        }
    ]
}
```

### 在线调试

您可以通过 Apifox 服务进行接口的在线调试：<https://zswsuv3jhf.apifox.cn/api-253901218>

### 注意事项

* 请求头中的 **elven-api-key**、**elven-api-sign** 和 **elven-api-timestamp** 为必填参数，用于验证请求的合法性和安全性。
* **page** 和 **limit** 参数为可选参数，不传递时默认返回第一页，每页10条数据。
* 返回结果中的 **list** 数组包含账户的详细信息，每一项与添加账户接口的返回值格式一致。
