1. Orders
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
        GET
      • Add Order
        POST
      • Update Document Order
        PUT
      • Get Order Detail
        GET
      • Update Order
        PATCH
      • Cancel Order
        PATCH
      • Get Order Finance
        GET
      • Get Returns Receiving Note
        GET
      • Get Goods Receipts
        GET
    • Returns Order
      • Get Returns Order List
      • Add Order Return
      • Get Return Order Detail
    • 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. Orders

Get Order List

GET
/api/v2/public/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/list?page=1&page_size=25&external_created_to=1704992399&external_created_from=1704906000&updated_from=1704906000&updated_to=1704992399&status=1&shop_id=1&is_tax=false&created_from=1704906000&created_to=1704992399&completed_time_from=1704906000&completed_time_to=1704992399&keyword=ODVN26081234ABCDEF' \
--header 'Seller-ID;' \
--header 'Country;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'
Response Response Example
Real response captured from the live API. Personal data replaced with placeholders.
{
  "data": {
    "count": 583,
    "next": "https://api.omisell.com/api/v2/public/order/list?external_created_from=1784090783&external_created_to=1786682783&page=2&page_size=2",
    "previous": null,
    "results": [
      {
        "order_number": "DH-0001",
        "omisell_order_number": "ODVN260805F24CA2C0",
        "created_time": 1785915163.0,
        "updated_time": 1785915222.0,
        "escrow_release_time": 0.0,
        "shop_id": 11311,
        "status_id": 700,
        "status_name": "Huỷ bởi người bán",
        "is_fulfilled": false
      },
      {
        "order_number": "260803337D95EM",
        "omisell_order_number": "ODVN260803C29657B7",
        "created_time": 1785746033.0,
        "updated_time": 1785746034.0,
        "escrow_release_time": 0.0,
        "shop_id": 11311,
        "status_id": 300,
        "status_name": "Đã duyệt",
        "is_fulfilled": false
      }
    ]
  },
  "error": false,
  "error_code": 200,
  "attr_error": null,
  "messages": "",
  "request_id": "6a7e9da03247762c56ed57c2"
}
Modified at 2026-11-03 04:22:17
Previous
Orders
Next
Add Order
Built with