---
title: "Fetch Refunds List"
method: GET
path: "/api/refund/{portone_order_ref}"
tags: ["Refund APIs"]
---

# Fetch Refunds List

`GET /api/refund/{portone_order_ref}`

## Request

- Base URL: `https://api.portone.cloud`
- URL: `https://api.portone.cloud/api/refund/{portone_order_ref}`
- Auth: none declared

Get the Refund details for the transaction created on PortOne. The response body contains the amount left to be refunded and the array of all refunds performed.

## Path parameters

- `portone_order_ref` string, required

## Headers

- `X-Portone-Client-Key` string
- `Authorization` string

## Response `200`

Successful response

- object
  - `refundDetails` RefundContent[]: The array of Refund details
    - `refund_date` string: The date of the refund.
    - `refund_id` string: The unique reference of the refund request created by PortOne.
    - `psp_refund_id` string: The unique reference of the refund request created by PSP.
    - `amount` number, double: The amount of refund.
    - `currency` string: The currency of the refund/ transaction.
    - `refund_status` string: The status of the refund. Refer PortOne docs for additional details.
    - `refund_type` string: The type of the refund. Either partial/full. Refer PortOne docs for additional details.
    - `refund_reason` string: The reason of the refund request.
  - `amountToRefund` number, double: The amount remaining to refund

## Other responses

- `400`: Failure response
- `401`: Failure response

---

[API](https://skmtc.dev/portone/apis/refund-apis.md) - [All operations](https://skmtc.dev/portone/apis/refund-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/portone/apis/refund-apis/revisions/3b6124eb5090?raw)