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

# List orders

`GET /ecommerce/orders`

## Request

- Base URL: `https://unify.apideck.com`
- URL: `https://unify.apideck.com/ecommerce/orders`
- Auth: API key in header `Authorization`

Returns a paginated list of orders from the connected ecommerce platform.

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string

## Response `200`

Orders returned

- OrdersResponse
  - `status_code` integer
  - `status` string
  - `data` Order[]
    - `id` string
    - `number` string
    - `status` string
    - `currency` string
    - `total_amount` number
    - `customer_id` string
    - `updated_at` string, date-time
  - `meta` Meta: Cursor-based pagination metadata.
    - `items_on_page` integer
    - `cursors` object
      - `previous` string, nullable
      - `current` string, nullable
      - `next` string, nullable

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid API key.
- `404`: The requested resource, connection, or connector could not be found.

---

[API](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/revisions/1814558af2d7?raw)