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

# List Refunds

`GET /payouts/refunds`

Returns a list of all refunds intitated . You can filter the transactions based on status of the refund transaction by passing it in the query parameter. This API allows pagination with the default size of 50 refunds per page.

## Query parameters

- `status` 'CREATED' | 'REJECTED' | 'APPROVED' | 'FAILED' | 'ACCEPTED_BY_BANK' | 'PENDING_WITH_BANK'
- `size` integer
- `page` integer

## Response `200`

- object
  - `refund_id` string, required — Unique identifier for the refund transaction.
  - `deposit_amount` number, required — The deposit amount associated with the refund request.
  - `deposit_currency` string, required — The ISO 3 letter currency code for the deposit amount
  - `payment_id` string, required — Identifier of the payment transaction linked to this refund.
  - `status` 'CREATED' | 'APPROVED' | 'REJECTED' | 'ACCEPTED_BY_BANK' | 'PENDING_WITH_BANK' | 'FAILED', required — Current status of the refund process.
  - `amount` number, required — The amount that will be refunded
  - `currency` string, required — The ISO 3 letter currency code for the refund amount
  - `reason_code` 'CUSTOMER_REQUEST' | 'DUPLICATED_PAYMENT' | 'ORDER_CANCELLED' | 'FRAUDULENT_PAYMENT', required — Reason for the refund request
  - `description` string, required — Additional notes about the refund being created. Can include order references/customer-id for the refund being generated.
  - `external_reference` string, required — Useful for tracking and reporting the transaction on your end. e.g You can enter transaction ID of this refund maintained in your system
  - `benefeciary` object, required
    - `name` string, required — Name of the beneficiary to which refund is being processed
    - `iban` string, required — IBAN account details of benefeicary
    - `city` string, required — City associated with the beneficiary account
  - `created_at` string, date-time, required — Timestamp when the refund was created
  - `created_by` string, required — Identifier of the user that initiated the refund
  - `actioned_by` string — Identifier of the user that confirmed or rejected the refund

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)