**版本：202601**

# 查询退款记录数量

**GET** `/openapi/2026-01/orders/refund_records/count`

返回符合过滤条件的退款记录总数，过滤参数与列表接口一致，常用于分页 UI 和 数据看板。

## 请求

**Query参数**

- `order_ids` string[]

  按订单 ID 过滤，最多支持 10 个。 示例：?order\_ids=1001&order\_ids=1002
- `refund_order_ids` string[]

  按退款记录 ID 过滤，最多支持 20 个。 示例：?refund\_order\_ids=2001&refund\_order\_ids=2002
- `refund_statuses` string[]

  按退款状态过滤。

  *   pending: 退款中。
  *   finished: 退款完成。
  *   failed: 退款失败。 示例：?refund\_statuses=pending&refund\_statuses=finished
- `created_at_start` string

  按创建时间过滤的起始值（如 2018-11-02T12:30:10Z）
- `created_at_end` string

  按创建时间过滤的结束值（如 2018-11-02T12:30:10Z）
- `updated_at_start` string

  按最后更新时间过滤的起始值（如 2018-11-02T12:30:10Z）
- `updated_at_end` string

  按最后更新时间过滤的结束值（如 2018-11-02T12:30:10Z）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `count` int32

    符合过滤条件的退款订单记录总数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0
  }
}
```