> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nocnoc/llms.txt
> Use this file to discover all available pages before exploring further.

# List orders

> Returns all orders associated with your account. Supports filtering by status, date range, and order ID.

<Note>Requests go to the live environment — all actions are real.</Note>

## Authorization

<ParamField header="X-Api-Key" type="string" required>
  Your seller API key. Provided by your nocnoc account manager.
</ParamField>

## Query parameters

<ParamField query="page" type="integer" required>
  Page number. Pagination starts at index zero.
</ParamField>

<ParamField query="size" type="integer" required>
  Number of results per page.
</ParamField>

<ParamField query="statuses" type="string">
  Filter by order status. Possible values: `in_process`, `cancelled`.
</ParamField>

<ParamField query="date_from" type="date">
  Filter orders created from this date.
</ParamField>

<ParamField query="date_to" type="date">
  Filter orders created up to this date.
</ParamField>

<ParamField query="order_id" type="string">
  Filter to retrieve a specific order by ID.
</ParamField>

## Returns

A paginated list of orders associated with your account, including order ID, status, items, and shipping details.

## Example request

```bash theme={null}
curl "https://live.nocnocstore.com/api/v2/orders?page=0&size=10&statuses=in_process" \
  -H "X-Api-Key: YOUR_SELLER_KEY"
```

<ResponseExample>
  ```json 200 theme={null}
  {
    "orders": [
      {
        "tracking_id": "NC2202936",
        "label_url": "https://www.live.nocnocstore.com/token/OL2342342.234234",
        "created_at": "2025-05-16 08:39:29",
        "status": "in_process",
        "status_date": "2025-05-16 08:45:39",
        "status_description": null,
        "customer": {
          "full_name": "Joe Doe",
          "tax_id": "01564525295"
        },
        "products": [
          {
            "sku": "6291107456058",
            "quantity": 1,
            "fob_price": "20.00"
          }
        ],
        "delivery_address": {
          "contact_name": "Nocnoc",
          "belongs_to": "NOCNOC",
          "contact_phone": "3055134548 Ext 70129",
          "street": "13150 NW 25TH ST",
          "street_2": "",
          "zipcode": "33182-1532",
          "region": "Florida",
          "city": "Miami",
          "country": "US",
          "deadline": "2025-05-18"
        }
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "code": 401,
    "message": "Unauthorized"
  }
  ```
</ResponseExample>