---
title: "Get all refunds for a payment"
method: GET
path: "/v1/payments/{paymentId}/refunds"
tags: ["Refunding payments"]
---

# Get all refunds for a payment

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

Return refunds for a payment. The Authorisation token needs to be specified in the 'authorization' header as 'authorization: Bearer YOUR_API_KEY_HERE'

## Path parameters

- `paymentId` string, required

## Response `200`

OK

- RefundForSearchResult
  - `payment_id` string
  - `_links` RefundLinksForSearch — links for search refunds resource
    - `self` Link — A link related to a payment
      - `href` string
      - `method` string
    - `payment` Link — A link related to a payment
      - `href` string
      - `method` string
  - `_embedded` EmbeddedRefunds
    - `refunds` Refund[]
      - `refund_id` string
      - `created_date` string
      - `amount` integer
      - `_links` RefundLinksForSearch — links for search refunds resource
        - `self` Link — A link related to a payment
          - `href` string
          - `method` string
        - `payment` Link — A link related to a payment
          - `href` string
          - `method` string
      - `status` 'submitted' | 'success' | 'error'

## Other responses

- `401` — Credentials are required to access this resource
- `404` — Not found
- `429` — Too many requests
- `500` — Downstream system error

## Changes

- **2019-08-01** `6e01c8022b87` — 2 info
  - api tag `Refunding payments` added
  - api tag `Refunds` removed
- **2019-07-31** `f8066d82895d` — 1 info
  - api operation id `getRefunds` removed and replaced with `Get all refunds for a payment`
- **2019-07-31** `ef50a2b1c4f1` — 2 info
  - api tag `Refunds` added
  - api tag `refunds` removed
- **2019-02-22** `89daf4ffa64f` — 3 info
  - api operation id `Get all refunds for a payment` removed and replaced with `getRefunds`
  - api tag `refunds` added
  - api tag `Refunding card payments` removed

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

---

[API](https://skmtc.dev/alphagov/apis/gov-uk-pay-api.md) · [All operations](https://skmtc.dev/alphagov/apis/gov-uk-pay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphagov/apis/gov-uk-pay-api/revisions/6e01c8022b87?raw)