---
title: "List refunds"
method: GET
path: "/v1/payments/{paymentId}/refunds"
tags: ["Payments"]
---

# List refunds

`GET /v1/payments/{paymentId}/refunds`

Retrieve all refunds for a specific payment.

## Path parameters

- `paymentId` string, uuid, required

## Response `200`

Refunds listed.

- object
  - `refunds` Refund[]
    - `id` string, uuid
    - `txId` string
    - `amount` number
    - `reason` string
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'REFUNDED' — Generic transaction status.
    - `processedAt` string, date-time
    - `createdAt` string, date-time

## Other responses

- `401` — Missing or invalid authentication token.
- `404` — Resource not found.

## Changes

- **2026-04-14** `c75657100757` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/changes/v1/payments/:paymentId/refunds/get.md)

---

[API](https://skmtc.dev/yuvexpay/apis/yuvexpay-api.md) · [All operations](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/revisions/9d4ba1cc037c?raw)