> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Refunds for Your Merchant Account

> Retrieve a paginated list of refunds for your merchant account. Filter by date range and status, and use page and page_size to navigate large result sets.

Use this endpoint to retrieve a paginated list of all refunds associated with your merchant account. You can narrow results by supplying a `start_date` and `end_date` range, or filter by a specific `status` such as `SUCCESS`. Combine `page` and `page_size` to page through large result sets efficiently.

## Headers

**x-api-key** `string` *required*

Your secret API key used to authenticate all requests.

**Content-Type** `string` *required*

Must be `application/json`.

## Request Parameters

**page** `integer` *required*

Page number for pagination. Start at `1` to retrieve the first page of results.

**page\_size** `integer` *required*

Number of records to return per page.

**start\_date** `string`

Start date and time for filtering refunds. Use the format `YYYY-MM-DD HH:MM`, for example `2026-06-15 00:00`.

**end\_date** `string`

End date and time for filtering refunds. Use the format `YYYY-MM-DD HH:MM`, for example `2026-06-15 23:59`.

**status** `string`

Filter results by refund status. Pass `SUCCESS` to retrieve only successfully processed refunds.

## Response

A successful request returns a `200 OK` with a JSON body containing a paginated array of refund records.

**data** `array`

Array of refund objects matching your filter criteria.

**page** `integer`

The current page number returned.

**page\_size** `integer`

Number of records returned per page.

**total** `integer`

Total number of refund records matching your filter.

> [!NOTE]
>
> Omit `start_date`, `end_date`, and `status` to retrieve all refunds without date or status filtering. Only `page` and `page_size` are required.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.