---
title: "Create a return"
method: POST
path: "/returns"
tags: ["Returns"]
---

# Create a return

`POST /returns`

Creates an order return request for full, partial, or combined refunds and returns processing details for each requested return.

Use the **Examples** dropdown in the **Try It!** panel to select a request body:

  | Example           | Description                                                                                         |
  |-------------------|-----------------------------------------------------------------------------------------------------|
  | **Full return**   | Submits a full refund for the specified order, returning 100% of its value without item‑level details. |
  | **Partial return**| Issues a partial refund for the specified order, refunding only the listed items and amounts.       |
  | **Combined return**| Mixes modes: one order is fully refunded, while another gets a partial refund on specified items.  |

## Request body

- PostReturnsRequest
  - `returns` object[], required
    - `order` string, required — Unique identifier for the order being returned or the order reference.
    - `reason` 'COMPATIBILITY_ISSUE' | 'DISCOUNT' | 'DUPLICATE_ORDER' | 'FRAUDULENT' | 'ORDER_ERROR' | 'PRODUCT_DIFFERENCE' | 'PRODUCT_NOT_RECEIVED' | 'TAX_REFUND' | 'OTHER' | 'NONE' — Reason code for the return. The `reason` key in the request body accepts the following 10 unique values: | **Key** | **Reason** | |------------------------------|--------------------------------------------| | `TAX_REFUND` | Tax return | | `PRODUCT_NOT_RECEIVED` | Product not received | | `PRODUCT_DIFFERENCE` | Product not as expected | | `FRAUDULENT` | Fraudulent transaction | | `ORDER_ERROR` | Incorrect order or order error | | `DISCOUNT` | Discount or coupon | | `DUPLICATE_ORDER` | Duplicate order | | `COMPATIBILITY_ISSUE` | Compatibility issue | | `OTHER` | Other reason | | `NONE` | None | If your payload contains a value that doesn't match those in this table, FastSpring will still create the return but insert `None` as the reason for the return.
    - `note` string — Optional, customer-visible note explaining the return reason.
    - `notification` 'ORIGINAL' | 'NONE' — Notify the customer of the return via email. - `ORIGINAL` = Yes, notify the customer. - `NONE` = No notification.
    - `refundType` 'FULL' | 'PARTIAL' — Type of refund. Defaults to `FULL` if omitted.
    - `items` object[] — List of return items. Ignored when refundType = FULL.
      - `product` string, required — Unique product path ID of the item.
      - `amount` integer — Amount for partial refunds.

## Response `200`

OK

- PostReturnsResponse
  - `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 to marketing emails.
    - `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.
      - `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.

## Other responses

- `400` — Bad Request

---

[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)