---
title: "Get information about a payment’s refunds"
method: GET
path: "/v1/payments/{paymentId}/refunds"
tags: ["Refunding card payments"]
---

# Get information about a payment’s refunds

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

You can use this endpoint to [get a list of refunds for a payment](https://docs.payments.service.gov.uk/refunding_payments/#get-all-refunds-for-a-single-payment).

## Path parameters

- `paymentId` string, required

## Response `200`

OK - your request was successful.

- RefundForSearchResult
  - `_embedded` EmbeddedRefunds
    - `refunds` Refund[]
      - `_links` RefundLinksForSearch — links for search refunds resource
        - `payment` Link — A link related to a payment
          - `href` string — A URL that lets you perform additional actions to this payment when combined with the associated `method`.
          - `method` string — An API method that lets you perform additional actions to this paymentwhen combined with the associated `href`.
        - `self` Link — A link related to a payment
          - `href` string — A URL that lets you perform additional actions to this payment when combined with the associated `method`.
          - `method` string — An API method that lets you perform additional actions to this paymentwhen combined with the associated `href`.
      - `amount` integer — The amount refunded to the user in pence.
      - `created_date` string — The date and time you created this refund. This value uses Coordinated Universal Time (UTC) and ISO 8601 format - `YYYY-MM-DDThh:mm:ss.SSSZ`.
      - `payment_id` string — The unique ID GOV.UK Pay automatically associated with this payment when you created it.
      - `refund_id` string — The unique ID GOV.UK Pay automatically associated with this refund when you created it.
      - `settlement_summary` RefundSettlementSummary — A structure representing information about a settlement for refunds
        - `settled_date` string — The date Stripe took the refund from a payout to your bank account. `settled_date` only appears if Stripe has taken the refund. This value uses Coordinated Universal Time (UTC) and ISO 8601 format - `YYYY-MM-DD`.
      - `status` 'submitted' | 'success' | 'error' — The [status of the refund](https://docs.payments.service.gov.uk/refunding_payments/#checking-the-status-of-a-refund-status).
  - `_links` RefundLinksForSearch — links for search refunds resource
    - `payment` Link — A link related to a payment
      - `href` string — A URL that lets you perform additional actions to this payment when combined with the associated `method`.
      - `method` string — An API method that lets you perform additional actions to this paymentwhen combined with the associated `href`.
    - `self` Link — A link related to a payment
      - `href` string — A URL that lets you perform additional actions to this payment when combined with the associated `method`.
      - `method` string — An API method that lets you perform additional actions to this paymentwhen combined with the associated `href`.
  - `payment_id` string — The unique ID GOV.UK Pay associated with this payment when you created it.

## Other responses

- `401` — Your API key is missing or invalid. Read more about [authenticating GOV.UK Pay API requests](https://docs.payments.service.gov.uk/api_reference/#authentication)
- `404` — Not found
- `429` — Too many requests
- `500` — Downstream system error

---

[API](https://skmtc.net/government-digital-service/apis/gov-uk-pay-api.md) · [All operations](https://skmtc.net/government-digital-service/apis/gov-uk-pay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/government-digital-service/gov-uk-pay-api/revisions/4dc2d80f453a/schema)