# Query Account

### API Overview

This API retrieves a list of accounts in the system and supports paginated queries.

* **Request Method：**`GET`
* **Request URL：**`https://openapi.elven.com/open/v3/entityAccount`

### Request Headers

<table><thead><tr><th width="202">Parameter Name</th><th width="90">Type</th><th width="100">Required</th><th>Description</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>Yes</td><td>The API key assigned to you</td></tr><tr><td>elven-api-sign</td><td>String</td><td>Yes</td><td>Request signature, used to verify the legitimacy of the request</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>Yes</td><td>Request timestamp, in milliseconds</td></tr></tbody></table>

[View Details](https://docs.elven.com/v3/~/changes/YkdBoYHdjwadymwIANKf/openapi/obtaining-api-authorization?r=LJbAoiJKFX1i7Py2GCYr)

### Request Parameters

#### Query 参数

<table><thead><tr><th width="184">Parameter Name</th><th width="119">Type</th><th width="102">Required</th><th>Description</th></tr></thead><tbody><tr><td>page</td><td>Number</td><td>No</td><td>The page number to retrieve. Defaults to 1 if not provided.</td></tr><tr><td>limit</td><td>Number</td><td>No</td><td>The number of records per page. Defaults to 10 if not provided.</td></tr></tbody></table>

#### Example Request

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

### Response Parameters

<table><thead><tr><th width="183">Parameter Name</th><th width="111">Type</th><th>Description</th></tr></thead><tbody><tr><td>total</td><td>Number</td><td>Total number of accounts in the system.</td></tr><tr><td>list</td><td>Array</td><td>A list of account details. Each element is a JSON object containing account information.</td></tr></tbody></table>

#### list 数组元素

<table><thead><tr><th width="183">Parameter Name</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>entityAccountId</td><td>String</td><td>Account  Primary Key</td></tr><tr><td>name</td><td>String</td><td>Account Name</td></tr><tr><td>platformId</td><td>String</td><td>PlatformId Primary Key</td></tr><tr><td>identity</td><td>String</td><td>Account Address</td></tr><tr><td>memo</td><td>String</td><td>memo</td></tr></tbody></table>

#### Example Response

```json
{
    "total": 100,
    "list": [
        {
            "entityAccountId": "xxxx",
            "name": "account1",
            "platformId": "xxx",
            "identity": "xxx",
            "memo": ""
        },
        {
            "entityAccountId": "yyyy",
            "name": "account2",
            "platformId": "yyy",
            "identity": "yyy",
            "memo": "this is memo"
        }
    ]
}
```

### **Notes**

* The following headers are required for all requests to ensure security and validity: elven-api-key,elven-api-sign,elven-api-timestamp
* **Pagination:** The page and limit parameters are optional. If omitted, the API will default to returning the first page with 10 records per page.
* **Response Format:**  The list array in the response contains detailed account information, with each element matching the structure of the return value from the Add Account API.