> ## Documentation Index
> Fetch the complete documentation index at: https://redo-44af351d-docs-v3-graphql-api-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Returns

> Returns, exchanges, claims, and their line items.

## Queries

* [`return`](/docs/api-reference/v3/reference/returns/queries/return) — Fetch a
  single return by its id — a branded Redo return id or its legacy Mongo
  ObjectId.
* [`returns`](/docs/api-reference/v3/reference/returns/queries/returns) — List
  returns, optionally filtered by status, customer email, order name, or update
  time.

## Mutations

* [`tagReturn`](/docs/api-reference/v3/reference/returns/mutations/tag-return) —
  Apply tags to a return by name. `SET` replaces the return's tags; `APPEND`
  unions them in. Returns null if no return with that id is owned by the caller.

## Objects

* [Assessment](/docs/api-reference/v3/reference/returns/assessment) — A merchant
  assessment recorded while processing an item.
* [AssessmentResponse](/docs/api-reference/v3/reference/returns/assessment-response)
  — One response within an assessment.
* [AssessmentUser](/docs/api-reference/v3/reference/returns/assessment-user) —
  The user assigned to an assessment. Only the id is stored on the returns
  mirror; name/email require the user directory and are empty here.
* [ExchangeItem](/docs/api-reference/v3/reference/returns/exchange-item) — An
  item on the exchange/new order.
* [ExchangeItemPrice](/docs/api-reference/v3/reference/returns/exchange-item-price)
  — The price of an exchange item, with tax.
* [ExchangeOrder](/docs/api-reference/v3/reference/returns/exchange-order) — The
  exchange/new order created for the return.
* [ExternalRef](/docs/api-reference/v3/reference/returns/external-ref) — A
  reference to an external product or variant by id and name.
* [ExternalReturnId](/docs/api-reference/v3/reference/returns/external-return-id)
  — An id for this return in an external system (e.g. Shopify).
* [ItemRefund](/docs/api-reference/v3/reference/returns/item-refund) — The
  refund for a single returned item.
* [MultipleChoiceQuestion](/docs/api-reference/v3/reference/returns/multiple-choice-question)
  — A multiple-choice question and its answer on a return item.
* [PersonName](/docs/api-reference/v3/reference/returns/person-name) — A
  person's given and family name.
* [Return](/docs/api-reference/v3/reference/returns/return) — A return,
  exchange, claim, or warranty a customer opened on an order.
* [ReturnAmount](/docs/api-reference/v3/reference/returns/return-amount) — A
  single monetary amount.
* [ReturnDestination](/docs/api-reference/v3/reference/returns/return-destination)
  — Where the returned items are shipped to (the merchant).
* [ReturnDropoff](/docs/api-reference/v3/reference/returns/return-dropoff) — A
  chosen dropoff for returning items without a printed label.
* [ReturnExchange](/docs/api-reference/v3/reference/returns/return-exchange) —
  Exchange details for the return.
* [ReturnGiftCard](/docs/api-reference/v3/reference/returns/return-gift-card) —
  A gift card issued as part of the return.
* [ReturnIntegration](/docs/api-reference/v3/reference/returns/return-integration)
  — A link between this return and an external integration.
* [ReturnItem](/docs/api-reference/v3/reference/returns/return-item) — A single
  item on the return.
* [ReturnItemExchangeItem](/docs/api-reference/v3/reference/returns/return-item-exchange-item)
  — The product exchanged for a returned item.
* [ReturnNote](/docs/api-reference/v3/reference/returns/return-note) — A
  non-system note on the return's timeline.
* [ReturnOrder](/docs/api-reference/v3/reference/returns/return-order) — The
  order this return was created against.
* [ReturnRefund](/docs/api-reference/v3/reference/returns/return-refund) — A
  refund transaction issued for the return.
* [ReturnShipment](/docs/api-reference/v3/reference/returns/return-shipment) — A
  return shipment and its tracking details.
* [ReturnSource](/docs/api-reference/v3/reference/returns/return-source) — Who
  the return is from (the customer).
* [ReturnTag](/docs/api-reference/v3/reference/returns/return-tag) — A tag
  applied to the return.
* [ReturnTotals](/docs/api-reference/v3/reference/returns/return-totals) — The
  monetary totals for the return.

## Enums

* [ReturnCompensationMethod](/docs/api-reference/v3/reference/returns/return-compensation-method)
  — How a customer is compensated for a return.
* [ReturnItemStatus](/docs/api-reference/v3/reference/returns/return-item-status)
  — The processing status of a single returned item.
* [ReturnItemStrategy](/docs/api-reference/v3/reference/returns/return-item-strategy)
  — The compensation strategy applied to a returned item.
* [ReturnProvisionType](/docs/api-reference/v3/reference/returns/return-provision-type)
  — When an exchange or store credit is provisioned.
* [ReturnSortKey](/docs/api-reference/v3/reference/returns/return-sort-key) — A
  field this list can be ordered by; pass to the list's `orderBy` argument and
  pair with `reverse` to flip direction.
* [ReturnStatus](/docs/api-reference/v3/reference/returns/return-status) — The
  lifecycle status of a return.
* [ReturnType](/docs/api-reference/v3/reference/returns/return-type) — What kind
  of return this is.