---
title: "GET /refunds"
method: GET
path: "/refunds"
tags: ["Refunds"]
---

# GET /refunds

`GET /refunds`

Get a paginated list of refunds for the marketplace. Custom sorting is not allowed, and results are sorted by Refund ID.

## Query parameters

- `offset` integer
- `limit` integer
- `dir` 'next' | 'prev'

## Response `200`

Successful operation

- object
  - `data` RefundService — Refund
    - `id` integer — The SamCart ID for the refund
    - `charge_id` integer — The SamCart ID for the charge
    - `cart_item_id` integer — The ID for the refunded cart item
    - `created_at` string, date-time — The UTC date and time the refund was issued
    - `test_mode` boolean — Indicates whether the transaction was done while the transaction was in test mode.
    - `charge_refund_status` 'refunded' | 'partially_refunded', nullable — Indicates whether a refund and the type of refund. If no refund was created the value will be null.
    - `currency` string — This will match the currency that the original charge was created in and will be the currency of the created refund
    - `refund_amount` integer — The total refund amount (in cents)
    - `remaining_refundable_amount` integer — The remaining refundable amount on the charge after this refund (in cents)
    - `charge` ChargeTransformer — Charges
      - `id` integer — The id of the charge
      - `charge_date` string, date-time, nullable — The UTC date and time that the charge was applied.
      - `total` integer, nullable — The total amount charged in cents.
      - `test_mode` boolean — Whether the charge was created in test mode or not.
      - `processor_transaction_id` string — The transaction ID from the processor.
      - `currency` string — The currency type used for the charge.
      - `card_used` string, nullable — The last 4 digits of the card used.
      - `paypal_email` string, nullable — The paypal email used.
    - `order` OrderTransformer — Orders
      - `id` integer — The id of the order
      - `test_mode` boolean — Whether the order was created in test mode or not.
      - `subtotal` integer — The order subtotal in cents.
      - `total` integer — The order subtotal in cents.
      - `shipping` integer — The order shipping in cents.
      - `tax` integer — The order tax in cents.
  - `pagination` Pagination — Optional information for paginating large data sets.
    - `next` string, uri, nullable — A URL to the next page of data to be retrieve. If current page is the last page this value will be null.
    - `prev` string, uri, nullable — A URL to the previous page of data to be retrieve. If current page is the first page this value will be null.

---

[API](https://skmtc.dev/samcart/apis/samcart-public-api.md) · [All operations](https://skmtc.dev/samcart/apis/samcart-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/samcart/samcart-public-api/revisions/80296f7a00d0/schema)