1. Returns Order
Omisell Developer Portal | API Documentation & Integration Guides
  • Authentication
  • Common Errors
  • Overview
    • Introduction
    • Push Mechanism
    • Status overview
    • Accounting - API Call Flow
    • ERP Integration Flow
    • API Rate Limits
    • Guide: Direct Integration
    • MCP Server
    • Pagination
  • Changelog
    • 🔐 API Security Upgrade
    • Orders
    • Returns Order
    • Products
    • Shipments
    • Push mechanism
  • API Refference
    • Location
      • Get Country List
      • Get Province List By Country
      • Get District List By Province
      • Get SubDistrict List By District
    • Product
      • Get Product Category
      • Get Product List
      • Add Product
      • Get Product Detail
      • Update Product Detail
      • Get Product Detail by SKU
      • Update Product Detail by SKU
    • Inventory
      • Adjust Stock
      • Delisted Stock
      • Adjust Stock(Old)
    • Serial Number
      • Adjust Serial Number
    • Catalogue
      • Get Catalogue List
      • Get Catalogue Detail
    • Orders
      • Get Order List
      • Add Order
      • Update Document Order
      • Get Order Detail
      • Update Order
      • Cancel Order
      • Get Order Finance
      • Get Returns Receiving Note
      • Get Goods Receipts
    • Returns Order
      • Get Returns Order List
        GET
      • Add Order Return
        POST
      • Get Return Order Detail
        GET
    • Shipments
      • Get Shipment List
      • Add Shipment
      • Update Document Shipment
      • Update Shipment Status
      • Get Shipment Detail
    • Order Dropship
    • Pickup Address
      • Get Pickup List
      • Get WMS Pickup Map
    • Shop
      • Get Shop List
    • Finance
      • Get Order Revenue
      • Get Order Return Revenue
    • Customer
      • Get Customer Review List
    • Public
      • Get Seller by Partner
  • Webhooks
    • Order Status Push
    • Return Order Status Push
    • Shipment Status Push
    • Sale Invoice Request
  • eCommerce Platform
    • PrestaShop
    • Magento
    • Shopify
    • Woocommerce
    • Zalora
  1. Returns Order

Get Returns Order List

GET
/api/v2/public/order/return/list
Get returns order list

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Header Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.omisell.com/api/v2/public/order/return/list?page=1&page_size=25&external_created_to=1704992399&external_created_from=1704906000&updated_to=1704992399&updated_from=1704906000' \
--header 'Seller-ID;' \
--header 'Country;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'
Response Response Example
{
    "data": {
        "count": 5,
        "next": "https://api.omisell.com/api/v2/public/order/return/list?external_created_from=1770000000&external_created_to=1790000000&page=2&page_size=3",
        "previous": null,
        "results": [
            {
                "omisell_return_order_number": "RTNVN260814713258D7",
                "return_order_number": "DOC-EXAMPLE-RET-1786683322",
                "order_number": "DOC-EXAMPLE-ORDER-1786683260",
                "shop_id": 34251,
                "status_id": 100,
                "status_name": "Requested",
                "created_time": 0,
                "updated_time": 1788239461.0
            },
            {
                "omisell_return_order_number": "RTNVN2606030D62FE4C",
                "return_order_number": "RTNVN2606030D62FE4C",
                "order_number": "EMP2_F230_SDALazada13",
                "shop_id": 11305,
                "status_id": 800,
                "status_name": "Returned",
                "created_time": 1780478979,
                "updated_time": 1780479063.0
            },
            {
                "omisell_return_order_number": "RTNVN2604248C007E86",
                "return_order_number": "RTNVN2604248C007E86",
                "order_number": "EMP2_F200_0037",
                "shop_id": 11311,
                "status_id": 300,
                "status_name": "Processing",
                "created_time": 1777021981,
                "updated_time": 1777021981.0
            }
        ]
    },
    "error": false,
    "error_code": 200,
    "attr_error": null,
    "messages": "",
    "request_id": "6a978953406e977bf2e587ce"
}
Modified at 2026-11-03 04:22:17
Previous
Returns Order
Next
Add Order Return
Built with