---
title: "List Payment Refunds"
method: GET
path: "/refund/"
tags: ["Payins"]
---

# List Payment Refunds

`GET /refund/`

Retrieve a list of payin refunds.

## Query parameters

- `payment_id` string
- `refund_id` string
- `idempotency_key` string
- `date_from` string, date-time
- `date_to` string, date-time
- `page_number` integer
- `page_size` integer
- `limit` integer
- `cursor` string

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Response `200`

Successful Response

- RefundPaymentListResponse
  - `next_cursor` string
  - `has_more` boolean
  - `status` 'success'
  - `data` PayinRefundResponse[], required
    - `id` string, required — Refund ID
    - `created_at` string, date-time, required — Creation date of the refund
    - `updated_at` string, date-time — Last update date of the refund
    - `idempotency_key` string — Idempotency key for the refund request, it can also be used as an external identifier
    - `status` 'PENDING' | 'SUCCESS' | 'FAILED', required — Status of the refund
    - `description` string — Description for the refund. If supported by the rail, this will be forwarded to the end user.
    - `debit_movement_id` integer — Debit movement that was originated from the refund
    - `bounce_movement_id` integer — Credit movement that was originated from the refund bounce, if applicable
    - `company` CompanyToIncludeInResponses
      - `id` string, required
      - `name` string, required
    - `voucher_id` string — Voucher ID associated with the refund, if applicable
    - `failure_reason` string — Reason for refund failure, if applicable
    - `payment_id` string — Payment ID that was refunded

## Other responses

- `403` — Forbidden
- `422` — Validation Error
- `500` — Internal Server Error

---

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