---
title: "Search for returns"
method: GET
path: "/returns"
tags: ["returns"]
---

# Search for returns

`GET /returns`

ADD ENDPOINT DESCRIPTION HERE

## Query parameters

- `query` string
- `sort` string
- `page` integer
- `searchAfter` string
- `pageSize` integer

## Response `200`

successful operation

- ReturnShipmentSummary[]
  - `warehouseId` integer
  - `returnShipmentIdentifier` string
  - `sellerId` integer
  - `returnShipmentId` integer
  - `orderId` integer
  - `fulfillmentOrderId` integer
  - `returnAnnouncementId` integer
  - `receivedDate` string, date-time
  - `shipFromCountry` string
  - `shipFromZip` string
  - `shipFromCompany` string
  - `shipFromName1` string
  - `shipFromName2` string
  - `sort` JsonNode
    - `float` boolean
    - `short` boolean
    - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
    - `number` boolean
    - `double` boolean
    - `binary` boolean
    - `integralNumber` boolean
    - `boolean` boolean
    - `long` boolean
    - `int` boolean
    - `valueNode` boolean
    - `containerNode` boolean
    - `missingNode` boolean
    - `object` boolean
    - `pojo` boolean
    - `floatingPointNumber` boolean
    - `bigDecimal` boolean
    - `bigInteger` boolean
    - `textual` boolean
    - `array` boolean
    - `null` boolean
  - `trackingLink` string
  - `trackingNumber` string
  - `carrierSlug` string
  - `returnShipmentReference` string
  - `customerExamined` boolean
  - `positions` ReturnShipmentPositionSummary[]
    - `sellerSku` string
    - `warehouseSku` string
    - `name` string
    - `quantity` integer
    - `classCode` string
    - `lot` string
    - `expirationDate` string, date-time
    - `serialNumbers` string[]
    - `reasonCode` string
    - `reasonDescription` string
    - `classDescription` string
    - `positionIdentifier` string
  - `groupedPositions` GroupedReturnShipmentPositionSummary[]
    - `sellerSku` string
    - `warehouseSku` string
    - `name` string
    - `quantity` integer
    - `classCode` string
    - `lot` string
    - `expirationDate` string, date-time
    - `serialNumbers` string[]
    - `reasonCode` string
    - `reasonDescription` string
    - `classDescription` string

---

[API](https://skmtc.dev/writechoiceorg/apis/connector.md) · [All operations](https://skmtc.dev/writechoiceorg/apis/connector/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/writechoiceorg/connector/revisions/7ce09a4b2a4e/schema)