---
search:
  tags:
    - Bestellungen
    - GET
seo:
  description: >-
    Bestellungen auflisten. Erfordert start und end. Optionales paymentState
    filtert nach Zahlungsstatus. Neueste zuerst. Mit limit und optionalem
    cursor…
sidebar:
  label: Bestellungen auflisten
  badge: GET
title: Bestellungen auflisten
type: openapi-operation
---
Bestellungen auflisten. Erfordert `start` und `end`. Optionales `paymentState` filtert nach Zahlungsstatus. Neueste zuerst. Mit `limit` und optionalem `cursor` paginieren. Soft-gelöschte Bestellungen fehlen, ausser `includeDeleted=true`; diese Zeilen sind mit `deleted: true` markiert.

`GET /orders`

**Responses**

- `200` — Bestellungen mit Meta
- `400` — Ungültige Parameter oder ungültiger Body.
- `403` — Fehlender, unbekannter oder inaktiver API-Key oder ein Read-Key bei einem Schreibzugriff.

Response example, 200:

```json
{
  "data": [
    {
      "id": "order_01",
      "orderId": "order_01",
      "store": "store_01",
      "price": 4590,
      "paymentState": "successful",
      "orderDate": "2024-04-20T12:00:00.000Z",
      "transactionDate": "2024-04-20T12:00:01.000Z",
      "products": []
    }
  ],
  "meta": {
    "total": 1,
    "returned": 1,
    "limit": 1,
    "nextCursor": "order_02"
  }
}
```

Response example, 400:

```json
{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}
```

Response example, 403:

```json
{
  "statusCode": 403,
  "message": "Unknown Error",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/products"
}
```
