**Version: 202601**

# Get refund records count

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

Returns the total number of refund records matching the same filters accepted by the list endpoint. Useful for paging UIs and dashboards.

## Request

**Query Parameters**

- `order_ids` string[]

  Filter by order IDs. Up to 10 IDs are supported. Example: ?order\_ids=1001&order\_ids=1002
- `refund_order_ids` string[]

  Filter by refund record IDs. Up to 20 IDs are supported. Example: ?refund\_order\_ids=2001&refund\_order\_ids=2002
- `refund_statuses` string[]

  Filter by refund status.

  *   pending: refund in progress.
  *   finished: refund completed.
  *   failed: refund failed. Example: ?refund\_statuses=pending&refund\_statuses=finished
- `created_at_start` string

  Filter records created at or after this time (e.g., 2018-11-02T12:30:10Z)
- `created_at_end` string

  Filter records created at or before this time (e.g., 2018-11-02T12:30:10Z)
- `updated_at_start` string

  Filter records last updated at or after this time (e.g., 2018-11-02T12:30:10Z)
- `updated_at_end` string

  Filter records last updated at or before this time (e.g., 2018-11-02T12:30:10Z)

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `count` int32

    Total count of refund order records matching the filter conditions

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