---
title: "transactionRefunds"
method: GET
path: "/v2/transaction/{transactionUUID}/refunds"
tags: ["Create & Manage Transactions"]
---

# transactionRefunds

`GET /v2/transaction/{transactionUUID}/refunds`

Retrieve the current refund state for a specific transaction.

Returns two arrays:
- **`refunds`** — processed or pending reversal transactions. Shape matches a standard transaction object. Always present; empty when no refunds have been processed.
- **`queuedRefunds`** — individually tracked refunds that have been requested but not yet processed (e.g. the original transaction has not yet cleared). Each item has `id`, `referenceId`, `amount` (with `amount` and `currency`), and `status` (`queued` or `abandoned`). Always present; empty when nothing is queued.

The `id` on a queued refund item is the uuid assigned at the time POST /v2/reverseTransaction was called (either supplied by the client or system-generated). That same uuid becomes the `id` of the resulting reversal transaction once processed.

**Multiple reversals:** A transaction can have more than one independent reversal. Each POST /v2/reverseTransaction call produces its own record. Both `refunds` and `queuedRefunds` may contain multiple entries.

<details>
<summary><strong>Error Glossary</strong> (click to expand)</summary>

| Code | HTTP Status | Message |
|------|-------------|---------|
| `AP011` | 401 | Unauthorized |
| `AP101` | 401 | No authenticated user |
| `AP700` | 400 | Missing or invalid required parameter |
| `AP701` | 400 | Improperly formatted parameter |

</details>

## Headers

- `Content-Type` string
- `authorization` string, required

## Response `200`

Success - Transaction refunds retrieved

- TransactionRefundsResponse
  - `refunds` TransactionGetResponse[] — List of processed or pending refunds for the transaction. Empty array when only queued refunds exist.
    - `transaction` object
      - `id` string
      - `amount` object
        - `amount` integer
        - `currency` string
      - `status` string
      - `paymentType` string
      - `userId` string
      - `title` string
      - `referenceId` string
      - `attributes` object[]
      - `createdDate` string, date-time
      - `modifiedDate` string, date-time
      - `apFee` string
      - `isRtp` boolean
      - `merchantId` integer
      - `locationId` integer
      - `userAccountId` integer
  - `queuedRefunds` QueuedRefundItem[] — List of individually tracked refunds that have been requested but not yet processed. Each item carries its own id, referenceId, amount, and status. Empty array when no queued refunds exist.
    - `id` string, uuid — UUID4 assigned to this queued refund at creation. Will become the aeroTransaction.id when the queued refund is processed.
    - `referenceId` string, nullable — Merchant-provided reference supplied at the time POST /v2/reverseTransaction was called. null if none was provided. Stored as a transaction attribute when processed.
    - `amount` object
      - `amount` integer — Queued refund amount in cents
      - `currency` string — Currency code (e.g., USD)
    - `status` 'queued' | 'abandoned' — Current state of this queued refund entry. 'queued' means it is pending processing. 'abandoned' means it was superseded or cancelled before processing.

---

[API](https://skmtc.net/aero/apis/aeropay-v2-api.md) · [All operations](https://skmtc.net/aero/apis/aeropay-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aero/aeropay-v2-api/revisions/4700c4ceeaad/schema)