---
title: "Get Refund Details"
method: GET
path: "/v3/refunds/{refundId}"
---

# Get Refund Details

`GET /v3/refunds/{refundId}`

## Request

- Base URL: `https://apitest.myfatoorah.com`
- URL: `https://apitest.myfatoorah.com/v3/refunds/{refundId}`
- Auth: HTTP bearer

## Path parameters

- `refundId` string, required

## Response `200`

Refund Retrieved Successfully

- object
  - `IsSuccess` boolean: Indicates whether the refund details were retrieved successfully.
  - `Message` string: Response message associated with the request.
  - `ValidationErrors` object[]
    - `Name` string: Name of the field with validation error.
    - `Error` string: Description of the validation error.
  - `Data` object
    - `Refund` object: Contains the refund details.
      - `Id` string: Unique identifier of the refund
      - `Reference` string: The refund reference generated by MyFatoorah for following up with the finance team.
      - `Status` 'Refunded' | 'Canceled' | 'Pending': Current status of the refund. It takes one of the following values: 'Refunded', 'Canceled', or 'Pending'.
      - `InvoiceId` string: The InvoiceId of the refunded amount.
      - `ExternalIdentifier` string: External identifier provided when creating the refund.
      - `CreationDate` string: Date and time when the refund was created.
      - `RefundDate` string: Date and time when the refund was completed. It may be empty while the refund is pending.
      - `RRN` string: Refund Reference Number that the customer can check with their bank.
      - `Comment` string
      - `VendorComment` string: Comment provided in the refund request.
    - `Amount` object: Contains the refund amount and its distribution.
      - `BaseCurrency` string: Base currency of the account
      - `ValueInBaseCurrency` string: Total refund amount in the base currency.
      - `Distribution` object
        - `Vendor` number: Amount deducted from the vendor for the refund.
        - `Suppliers` object[]: Amount deducted from the suppliers for the refund.
          - `Code` string: Supplier code.
          - `Amount` number: Amount refunded by the supplier.
    - `ReferencedInvoice` object: Contains details of the original invoice.
      - `Id` string: Id of the original invoice.
      - `Reference` string: Reference number of the original invoice.
      - `ExternalIdentifier` string: External identifier of the original invoice.
      - `PaymentMethod` string: Payment method used for the original payment.
      - `BaseCurrency` string: The base currency of your account (e.g., KWD).
      - `ValueInBaseCurrency` string: The total value of the original invoice in base currency.
      - `RemainingValueInBaseCurrency` string: The remaining amount in base currency after the refund.

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-03** `00639fc15f06`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3/changes/v3/refunds/:refundId/get.md)

---

[API](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3.md) - [All operations](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3/revisions/00639fc15f06?raw)