---
title: "List Refunds"
method: GET
path: "/refunds"
tags: ["Refunds"]
---

# List Refunds

`GET /refunds`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `MerchantId`, `ApiKey`, `Environment`

This endpoint allows you to list your refunds

## Query parameters

- `fromDate` string
- `toDate` string
- `filterBy` 'createdAt' | 'updatedAt'
- `status` 'created' | 'pending' | 'pending_manual' | 'failed' | 'successful'
- `gatewayId` string
- `id` string
- `page` number
- `perPage` number

## Headers

- `MerchantId` string, required
- `ApiKey` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- PagedRefundsResponseDto
  - `data` RefundResponseDto[], required: Refunds of the current page
    - `id` number, required: Identifier of the refund
    - `transactionId` string, required: Identifier of the refunded transfer
    - `status` 'created' | 'pending' | 'pending_manual' | 'failed' | 'successful', required: Status of the refund
    - `amount` number, required: Refunded amount in the smallest currency unit
    - `currency` string, required: Three-letter ISO 4217 currency code
    - `reason` string, required: Reason of the refund
    - `paymentMethod` 'mobile_money' | 'bank_transfer', required: Method the refund is paid back with
    - `fallbackUsed` boolean, required: Whether the refund was paid back through the fallback method
    - `createdAt` string, date-time, required: Creation date of the refund, UTC
    - `updatedAt` string, date-time, required: Last update date of the refund, UTC
    - `failureCause` RefundPublicFailureCauseDto
      - `code` string, required: Hub2 failure code
      - `message` string: Human-readable failure message
  - `totalItems` number, required: Total number of refunds matching the filters
  - `currentPage` number, required: Current page number
  - `countPerPage` number, required: Number of refunds per page

## Other responses

- `401`: Wrong credentials
- `500`: Internal error

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/refunds/get.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)