---
title: "List orders"
method: GET
path: "/ecommerce/orders"
tags: ["Ecommerce — Orders"]
---

# List orders

`GET /ecommerce/orders`

## Request

- Base URL: `https://app.zobrx.com/api/v1`
- URL: `https://app.zobrx.com/api/v1/ecommerce/orders`
- Auth: HTTP bearer

Unified multi-channel order lines (Amazon, Flipkart, Meesho, Myntra, Snapdeal, JioMart, AJIO, Shopify, offline), newest first. Money is paise integers. Buyer PII (buyerName, shippingAddress) is null unless the key holds `ecommerce:pii:read`. Requires scope `ecommerce:orders:read`.

**Date filters:** `orderSince`/`orderUntil` filter by **order date** (the response's `orderDate`); `invoiceSince`/`invoiceUntil` filter by **invoice date** (the response's `invoiceDate`). Orders without an invoice date are excluded when an invoice-date filter is set. `since`/`until` are accepted as aliases of `orderSince`/`orderUntil`.

## Query parameters

- `orderSince` string, date-time
- `orderUntil` string, date-time
- `invoiceSince` string, date-time
- `invoiceUntil` string, date-time
- `channels` string
- `storeIds` string
- `attributionState` string
- `settlement` 'paid' | 'unpaid'
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

A page of orders.

- OrderList
  - `items` UnifiedOrder[]
    - `orderId` string, nullable
    - `lineItemId` string
    - `channelCode` string
    - `storeId` string
    - `sku` string
    - `marketplaceListingId` string, nullable
    - `productName` string
    - `qty` integer
    - `sellingPriceMinor` integer, nullable
    - `itemTaxMinor` integer, nullable
    - `netSettledPaymentMinor` integer, nullable
    - `feeMinor` integer, nullable
    - `currencyCode` string, nullable
    - `attributionState` string
    - `paymentType` string, nullable
    - `awbNumber` string, nullable
    - `courierPartner` string, nullable
    - `orderDate` string, date-time: When the order was placed (ISO 8601).
    - `invoiceDate` string, date-time, nullable: Tax-invoice date (ISO 8601), from the channel's GST/invoice data. null until the order is invoice-enriched.
    - `deliveredOn` string, date-time, nullable
    - `customerState` string, nullable
    - `customerPincode` string, nullable
    - `buyerName` string, nullable
    - `shippingAddress` object, nullable
    - `channelSpecific` object
  - `pagination` ListPagination
    - `total` integer
    - `limit` integer
    - `offset` integer
    - `hasMore` boolean
  - `perChannelCount` object

## Other responses

- `401`: Missing/invalid API key.
- `403`: The API key is missing the scope this endpoint requires.

---

[API](https://skmtc.dev/zobrx/apis/zobrx-api.md) · [All operations](https://skmtc.dev/zobrx/apis/zobrx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zobrx/apis/zobrx-api/revisions/af90eac50273?raw)