---
title: "Get one refund of the authenticated customer"
method: GET
path: "/customer-refunds/{id}"
tags: ["Customer Order"]
---

# Get one refund of the authenticated customer

`GET /customer-refunds/{id}`

## Request

- Base URL: `http://localhost:8000/api/shop`
- URL: `http://localhost:8000/api/shop/customer-refunds/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-shop-api/docs/customer-refunds/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single refund document with its refunded items and totals. A refund of another customer's order answers 404.

## Path parameters

- `id` string, required

## Headers

- `X-STOREFRONT-KEY` string, required
- `X-Locale` string
- `X-Channel` string
- `X-Currency` string

## Response `200`

CustomerRefund resource

- CustomerRefundCustomerRefundDto: Refund documents issued against the authenticated customer's orders, as shown on the storefront order view's refunds tab. Read-only and scoped to the order's customer.
  - `id` integer, nullable
  - `orderId` integer, nullable
  - `orderIncrementId` string, nullable
  - `incrementId` string, nullable
  - `state` string, nullable
  - `totalQty` integer, nullable
  - `baseCurrencyCode` string, nullable
  - `channelCurrencyCode` string, nullable
  - `orderCurrencyCode` string, nullable
  - `subTotal` number, nullable
  - `baseSubTotal` number, nullable
  - `subTotalInclTax` number, nullable
  - `baseSubTotalInclTax` number, nullable
  - `shippingAmount` number, nullable
  - `baseShippingAmount` number, nullable
  - `shippingAmountInclTax` number, nullable
  - `baseShippingAmountInclTax` number, nullable
  - `shippingTaxAmount` number, nullable
  - `baseShippingTaxAmount` number, nullable
  - `taxAmount` number, nullable
  - `baseTaxAmount` number, nullable
  - `discountPercent` number, nullable
  - `discountAmount` number, nullable
  - `baseDiscountAmount` number, nullable
  - `adjustmentRefund` number, nullable
  - `baseAdjustmentRefund` number, nullable
  - `adjustmentFee` number, nullable
  - `baseAdjustmentFee` number, nullable
  - `grandTotal` number, nullable
  - `baseGrandTotal` number, nullable
  - `formattedSubTotal` string, nullable
  - `formattedSubTotalInclTax` string, nullable
  - `formattedShippingAmount` string, nullable
  - `formattedShippingAmountInclTax` string, nullable
  - `formattedTaxAmount` string, nullable
  - `formattedDiscountAmount` string, nullable
  - `formattedAdjustmentRefund` string, nullable
  - `formattedAdjustmentFee` string, nullable
  - `formattedGrandTotal` string, nullable
  - `formattedBaseGrandTotal` string, nullable
  - `createdAt` string, nullable
  - `updatedAt` string, nullable
  - `items` RefundItemDto[]
    - `id` integer, nullable
    - `orderItemId` integer, nullable
    - `productId` integer, nullable
    - `sku` string, nullable
    - `name` string, nullable
    - `qty` integer, nullable
    - `price` number, nullable
    - `basePrice` number, nullable
    - `priceInclTax` number, nullable
    - `basePriceInclTax` number, nullable
    - `total` number, nullable
    - `baseTotal` number, nullable
    - `totalInclTax` number, nullable
    - `baseTotalInclTax` number, nullable
    - `taxAmount` number, nullable
    - `baseTaxAmount` number, nullable
    - `discountPercent` number, nullable
    - `discountAmount` number, nullable
    - `baseDiscountAmount` number, nullable
    - `formattedPrice` string, nullable
    - `formattedPriceInclTax` string, nullable
    - `formattedTotal` string, nullable
    - `formattedTotalInclTax` string, nullable
    - `formattedTaxAmount` string, nullable
    - `formattedDiscountAmount` string, nullable
    - `additional` unknown[], nullable
      - unknown

## Other responses

- `404`: Not found

## Changes

- **2026-10-28** `b84d43839844`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-shop-api/changes/customer-refunds/:id/get.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-shop-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-shop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-shop-api/revisions/f619df36bf29?raw)