---
title: "Retrieve a return"
method: GET
path: "/returns/{return_id}"
tags: ["Returns"]
---

# Retrieve a return

`GET /returns/{return_id}`

Retrieves the details of one or more returns.

## Path parameters

- `return_id` string, required

## Response `200`

OK

- GetReturnsResponse
  - `returns` object[]
    - `return` string — Unique identifier to reference a specific return.
    - `quote` string, nullable — Quote identifier associated with the return, if any.
    - `reference` string — Reference code for the return.
    - `completed` boolean — Indicates whether the return process has been completed.
    - `changed` number — Timestamp indicating when the return was last changed.
    - `changedValue` number — Value representing when the return was changed.
    - `changedInSeconds` number — Timestamp in seconds indicating when the return was changed.
    - `changedDisplay` string — Formatted display date for when the return was changed.
    - `changedDisplayISO8601` string, date — ISO8601 formatted date for when the return was changed.
    - `live` boolean — Indicates if the return is live.
    - `account` string — Identifier for the account associated with the return.
    - `currency` string — Currency of the return amount.
    - `payoutCurrency` string — Currency in which the payout is made.
    - `totalReturn` number — Total return amount.
    - `totalReturnDisplay` string — Formatted display of the total return amount.
    - `totalReturnInPayoutCurrency` number — Total return amount in payout currency.
    - `totalReturnInPayoutCurrencyDisplay` string — Formatted display of the total return amount in payout currency.
    - `tax` number — Tax amount on the return.
    - `taxDisplay` string — Formatted display of the tax amount on the return.
    - `taxInPayoutCurrency` number — Tax amount in payout currency.
    - `taxInPayoutCurrencyDisplay` string — Formatted display of the tax amount in payout currency.
    - `subtotal` number — Subtotal amount of the return.
    - `subtotalDisplay` string — Formatted display of the subtotal amount.
    - `subtotalInPayoutCurrency` number — Subtotal amount in payout currency.
    - `subtotalInPayoutCurrencyDisplay` string — Formatted display of the subtotal amount in payout currency.
    - `totalRefundInPayoutCurrency` number — Total refund amount in payout currency.
    - `payment` object — Payment details associated with the return.
      - `type` string — Type of payment.
      - `cardEnding` string — Last four digits of the card used for the payment.
    - `reason` string — Reason for the return.
    - `note` string — Additional notes regarding the return.
    - `type` string — Type of the return.
    - `refundPerformerType` string — Type of performer handling the refund.
    - `refundSourceComponent` string — Source component of the refund.
    - `original` object — Original order details associated with the return.
      - `id` string — Unique identifier for the original order.
      - `order` string — Order identifier.
      - `reference` string — Reference code for the original order.
      - `account` string — Account identifier associated with the original order.
      - `currency` string — Currency of the original order amount.
      - `payoutCurrency` string — Currency in which the payout was made for the original order.
      - `total` number — Total amount of the original order.
      - `totalDisplay` string — Formatted display of the total amount of the original order.
      - `totalInPayoutCurrency` number — Total amount in payout currency of the original order.
      - `totalInPayoutCurrencyDisplay` string — Formatted display of the total amount in payout currency of the original order.
      - `tax` number — Tax amount on the original order.
      - `taxDisplay` string — Formatted display of the tax amount on the original order.
      - `taxInPayoutCurrency` number — Tax amount in payout currency for the original order.
      - `taxInPayoutCurrencyDisplay` string — Formatted display of the tax amount in payout currency for the original order.
      - `subtotal` number — Subtotal amount of the original order.
      - `subtotalDisplay` string — Formatted display of the subtotal amount of the original order.
      - `subtotalInPayoutCurrency` number — Subtotal amount in payout currency of the original order.
      - `subtotalInPayoutCurrencyDisplay` string — Formatted display of the subtotal amount in payout currency of the original order.
      - `notes` string[] — List of notes associated with the original order.
      - `tags` object — Tags associated with the original order.
    - `customer` object — Customer details associated with the return.
      - `first` string — Customer's first name.
      - `last` string — Customer's last name.
      - `email` string — Customer's email address.
      - `company` string, nullable — Customer's company name, if any.
      - `phone` string — Customer's phone number.
      - `subscribed` boolean — Indicates if the customer is subscribed.
    - `items` object[]
      - `product` string — Product identifier.
      - `quantity` number — Quantity of the product returned.
      - `display` string — Display name of the product.
      - `sku` string, nullable — SKU of the product.
      - `refundType` string — Type of refund (e.g., Partial Refund).
      - `subtotal` number — Subtotal amount for the item.
      - `subtotalDisplay` string — Formatted display of the subtotal amount.
      - `subtotalInPayoutCurrency` number — Subtotal amount in payout currency.
      - `subtotalInPayoutCurrencyDisplay` string — Formatted display of the subtotal amount in payout currency.
      - `attributes` object — Attributes associated with the item.
      - `withholdings` object — Withholdings applied to the item.
        - `taxWithholdings` boolean — Indicates if tax is withheld for the item.
    - `refundPerformer` string — Identifier of the performer handling the refund.
    - `action` string — Action taken for the refund.
    - `result` string — Result of the refund action.

---

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