# Query Source

### API Overview

This API retrieves a list of Sources in the system, supporting paginated queries.

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

### 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="180">Parameter Name</th><th width="119">Type</th><th width="96">必填</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 <code>1</code> 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/transaction/source?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>The total number of Sources in the system.</td></tr><tr><td>list</td><td>Array</td><td>A list of Sources, where each element contains detailed information.</td></tr></tbody></table>

#### list 数组元素

<table><thead><tr><th width="189">Parameter Name</th><th width="113">Type</th><th>Description</th></tr></thead><tbody><tr><td>sourceId</td><td>String</td><td>The primary key of the source.</td></tr><tr><td>name</td><td>String</td><td>The name of the source.</td></tr><tr><td>entityAccountId</td><td>String</td><td>The primary key of the account associated with the source.</td></tr></tbody></table>

#### Example Response

```json
{
    "total": 100,
    "list": [
        {
            "sourceId": "xxx",
            "name": "Source1",
            "entityAccountId": "entityAccountId1"
        },
        {
            "sourceId": "yyy",
            "name": "Source2",
            "entityAccountId": "entityAccountId2"
        }
    ]
}
```

### **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.
* The list array in the response contains detailed information about each Source, following the same structure as the return value from the Create Source API.