---
title: "List Return Order"
method: POST
path: "/api/return-order/page"
tags: ["Return Order"]
---

# List Return Order

`POST /api/return-order/page`

## Request

- Base URL: `https://api.desty.app`
- URL: `https://api.desty.app/api/return-order/page`
- Auth: none declared. Required headers: `Authorization`

<span class="colour" style="color:rgb(0, 0, 0)">API to retrieve multiple return order information from Desty Omnichannel. The information provided is not as complete as the Return Order Detail. Use List Return Order API to retrieve orderId then subsequently request GET Return Order Detail API.</span>

## Headers

- `Authorization` string, required

## Request body

- object
  - `platform` string: Supported marketplace name: lazada, tokopedia, shopee, tiktok, blibli, zalora, destyStore, destyPos
  - `returnType` string: Return order type. Available value: Return / Refund / Replacement
  - `startDate` number: Return order create time (Start time) using unix timestamp in milliseconds
  - `endDate` number: Return order create time (Finish time) using unix timestamp in milliseconds
  - `status` string: Return order status. Available value: Pending / Processing / InDispute / Completed / Cancelled
  - `pageNumber` integer: The number of the pages. Counting starts from 1
  - `pageSize` integer: The number of orders within a page. Already set to 500 by default.

## Response `200`

successful operation

- object
  - `code` string: code
  - `msg` string: msg
  - `data` object: data
    - `pageNumber` integer
    - `pageSize` integer: Maximum pageSize is set to 500 by default
    - `totalPages` integer
    - `totalCount` integer
    - `results` object[]
      - `returnOrderId` string
      - `returnOrderSn` string
      - `returnType` string
      - `status` string
      - `orderId` string: The original orderId associated with the return order
      - `orderSn` string: The original order serial number associated with the return order
      - `orderCreateTime` number: timestamp
      - `orderUpdateTime` number: timestamp
      - `platformName` string
      - `storeId` string
      - `storeName` string
      - `initiator` string: Return Initiator
      - `reason` string
      - `buyerName` string
      - `courier` string
      - `shipmentNo` string
      - `refundAmount` number
      - `compensationAmount` number
      - `actionDeadline` number: timestamp
      - `closeDeadline` number: timestamp
      - `isStockReturned` boolean: Whether putting back stock in Omni has been processed

---

[API](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26.md) - [All operations](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/llms.txt) - [OpenAPI document](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/revisions/4946760fb77d?raw)