> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/platform-service/zbc/account/describetransactionhistory.md).

# DescribeTransactionHistory

## 1. 接口描述

本接口(DescribeTransactionHistory)用于获取账户的交易记录。最大返回条数为10000。不能查询超过10000条的数据，查询时间区间不得超过 3 个月。

## 2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

| 参数名称            | 必选 | 类型                                                                                                  | 描述                                                                                                                                                                          |
| --------------- | -- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| endTime         | 否  | String                                                                                              | <p>查询结束时间。</p><p>不传时取当前时间。</p><p>时间格式：yyyy-MM-ddTHH<span data-gb-custom-inline data-tag="emoji" data-code="1f1f2-1f1f2">🇲🇲</span>ssZ。</p>                                 |
| startTime       | 否  | String                                                                                              | <p>查询开始时间。</p><p>不传时取结束时间往前 1 个月。</p><p>与结束时间的间隔不得超过 3 个月。</p><p>时间格式：yyyy-MM-ddTHH<span data-gb-custom-inline data-tag="emoji" data-code="1f1f2-1f1f2">🇲🇲</span>ssZ。</p> |
| transactionType | 否  | Array of [TransactionType](/api-reference/cn/platform-service/zbc/datastructure.md#transactiontype) | <p>交易类型。</p><p>不传时返回全部类型的交易记录。</p>                                                                                                                                          |
| pageSize        | 否  | Integer                                                                                             | <p>每页大小。</p><p>默认 20。</p><p>与页码的乘积不得超过 10000。</p><p>可选值范围：\[1, +)</p><p>默认值：20</p>                                                                                          |
| pageNum         | 否  | Integer                                                                                             | <p>页码。</p><p>默认 1。</p><p>与每页大小的乘积不得超过 10000。</p><p>可选值范围：\[1, +)</p><p>默认值：1</p>                                                                                            |

## 3. 响应结果

| 参数名称           | 类型                                                                                                        | 描述                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| requestId      | String                                                                                                    | <p>唯一请求 ID。</p><p>每次请求都会返回。定位问题时需要提供该次请求的 requestId。</p> |
| incomeSum      | Float                                                                                                     | <p>总收入。</p><p>为符合筛选条件的全部记录汇总值，不受分页影响。</p>                |
| expenditureSum | Float                                                                                                     | <p>总支出。</p><p>为符合筛选条件的全部记录汇总值，不受分页影响。</p>                |
| totalCount     | Integer                                                                                                   | 符合条件的数据总数。                                               |
| dataSet        | Array of [AccountHistoryInfo](/api-reference/cn/platform-service/zbc/datastructure.md#accounthistoryinfo) | 交易记录结果集。                                                 |

## 4. 代码示例

{% tabs %}
{% tab title="示例" %}
**1. 查询账户的扣款交易记录。**

```json
POST /api/v2/zbc HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeTransactionHistory
<Common Request Params>

Request:
  {
    "startTime": "2023-08-05T14:26:18Z",
    "endTime": "2023-09-05T14:26:18Z",
    "transactionType": ["DEDUCTION"],
    "pageNum": 1,
    "pageSize": 3
  }

Response:
  {
    "requestId": "TDC8274BB-68DF-42A8-A827-5933DB122667",
    "response": {
      "requestId": "TDC8274BB-68DF-42A8-A827-5933DB122667",
      "incomeSum": 605.86,
      "expenditureSum": 7044.32,
      "totalCount": 15084,
      "dataSet": [
        {
          "uid": "8b2875e7-1340-4a3d-a056-a885c32f25de",
          "accountUid": "21205dbb-d08a-4f79-927d-861d47bc66d8",
          "transactionTime": "2023-09-05T13:00:42Z",
          "amount": 1.38,
          "cashBalance": 161.358301,
          "tradeType": "EXPENDITURE",
          "paymentMethod": "ZenPoint",
          "description": "Product: Virtual Machine - Elastic Disk//\nType: ens_ssd/FRA/de-frankfurt-9a - hourly billing",
          "transactionType": "DEDUCTION",
          "tradeNo": "f2c7f250-45ed-4734-8e03-e4ab5766da46",
          "orderSn": "967674789101568984"
        }
      ]
    }
  }
```

**2. 使用默认时间范围查询全部交易记录。**

```json
POST /api/v2/zbc HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeTransactionHistory
<Common Request Params>

Request:
  {
    "pageNum": 1,
    "pageSize": 20
  }

Response:
  {
    "requestId": "T3A91C0D2-7E45-4B18-9C6A-1F2E5D8B47A3",
    "response": {
      "requestId": "T3A91C0D2-7E45-4B18-9C6A-1F2E5D8B47A3",
      "incomeSum": 0.00,
      "expenditureSum": 128.45,
      "totalCount": 36,
      "dataSet": [
        {
          "uid": "223ec330-0148-4745-a33b-f5264b14aacf",
          "accountUid": "21205dbb-d08a-4f79-927d-861d47bc66d8",
          "transactionTime": "2023-09-05T13:00:42Z",
          "amount": 0.05,
          "cashBalance": 162.738301,
          "tradeType": "EXPENDITURE",
          "paymentMethod": "ZenPoint",
          "description": "Product: Virtual Machine - Instance Type//\nType: 01.VM.02.019/FRA9A_Shared_6326 - hourly billing",
          "transactionType": "DEDUCTION",
          "tradeNo": "a307e306-634e-4168-9549-2ac9dfaa4a33",
          "orderSn": "967674789101568984"
        }
      ]
    }
  }
```

{% endtab %}
{% endtabs %}

## 5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](/api-reference/cn/api-introduction/toolkit.md)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

## 6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](/api-reference/cn/api-introduction/instruction/commonerrorcode.md)

| HTTP状态码 | 错误码 | 说明 |
| ------- | --- | -- |