查询退款记录数量

GET 
/openapi/2026-07/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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

countint32

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

示例

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