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

# Einkäufe auflisten

> Alle Einkäufe Ihrer Organisation abrufen

Optional **`limit`** (1–5000, Standard 100) begrenzt die Anzahl der zurückgegebenen Bestellungen (neueste zuerst). Die Antwort-**`meta`** enthält `total`, `returned` und `limit` (`total` und `returned` entsprechen der Größe von `data` in dieser Antwort). Siehe [Einführung](/api-reference/de/introduction#listen-antworten-meta).


## OpenAPI

````yaml GET /orders
openapi: 3.0.1
info:
  title: Scango API
  description: >-
    API documentation for Scango's dashboard services.


    **List endpoints** (`GET /products`, `GET /orders`, `GET /suppliers`, `GET
    /categories`) return `data` plus `meta` with `total`, `returned`, and
    `limit` (applied page size; default **100**, maximum **5000** unless noted).
    Product search with `q` also includes `offset` and caps the effective page
    size at **250**. See schema `ListMeta`.
  version: 1.0.0
servers:
  - url: https://dashboard.scango.ch/api/v1
security:
  - bearerAuth: []
tags:
  - name: Products
    description: 'Product catalog: list, search, create, update, and delete.'
  - name: Orders
    description: Orders within a time range and single-order details.
  - name: Suppliers
    description: Supplier directory for your organization.
  - name: Categories
    description: Product categories.
paths:
  /orders:
    get:
      tags:
        - Orders
      summary: List orders
      description: >-
        Returns orders of a specific organization matching the filters, up to
        `limit` (default 100, max 5000), ordered by `orderDate` descending. The
        response includes `meta` with hit counts and the applied `limit`
        (`ListMeta`). `total` and `returned` are the number of orders in this
        response (not the full count across all matching orders).
      operationId: listOrders
      parameters:
        - name: start
          in: query
          description: 'Start date (Format: 2020-01-01T00:00:00Z)'
          schema:
            type: string
            format: date-time
        - name: end
          in: query
          description: 'End date (Format: 2020-01-01T00:00:00Z)'
          schema:
            type: string
            format: date-time
        - name: paymentState
          in: query
          description: Payment status filter
          schema:
            type: string
            enum:
              - successful
              - cancelled
              - timeout
              - failed
              - pending
        - name: limit
          in: query
          required: false
          description: Maximum number of orders to return. Integer 1–5000. Default 100.
          schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 100
      responses:
        '200':
          description: List of orders with `meta` (`ListMeta`).
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Order'
                  meta:
                    $ref: '#/components/schemas/ListMeta'
              example:
                data:
                  - id: order_01
                    orderId: order_01
                    instance: org_01
                    store: store_01
                    price: 4590
                    paymentState: successful
                    orderDate:
                      _seconds: 1713600000
                      _nanoseconds: 0
                    products: []
                meta:
                  total: 1
                  returned: 1
                  limit: 100
components:
  schemas:
    Order:
      type: object
      properties:
        id:
          type: string
        giftcardCurrentValue:
          type: integer
        instance:
          type: string
        orderId:
          type: string
        price:
          type: integer
        giftcardFunction:
          type: string
        paymentMethod:
          type: string
        store:
          type: string
        userId:
          type: string
        orderDate:
          type: object
          properties:
            _seconds:
              type: integer
            _nanoseconds:
              type: integer
        orderState:
          type: string
        giftcardId:
          type: string
        products:
          type: array
          items:
            type: object
            properties:
              quantity:
                type: integer
              productId:
                type: string
              netPrice:
                type: integer
              tax:
                type: integer
              title:
                type: string
              type:
                type: string
              taxRate:
                type: number
              originalProductId:
                type: string
              price:
                type: integer
              supplier:
                type: string
              imageUrl:
                type: string
              deposit:
                type: integer
              category:
                type: string
        paymentBrand:
          type: string
        transactionDate:
          type: object
          properties:
            _seconds:
              type: integer
            _nanoseconds:
              type: integer
        paymentState:
          type: string
          enum:
            - successful
            - cancelled
            - timeout
            - failed
            - pending
        transactionMessage:
          type: string
    ListMeta:
      type: object
      required:
        - total
        - returned
      description: >-
        Included on every list response. `returned` is the length of `data`. For
        Firestore-backed lists (`/products` without `q`, `/orders`,
        `/suppliers`, `/categories`), `total` equals `returned` for that
        response (the API does not return a separate full match count). For
        product search with `q`, `total` is the search index’s estimated number
        of matching documents. `limit` is the applied page size (query default
        **100**, maximum **5000**; search with `q` caps the effective page size
        at **250**). `offset` is only used for product search with `q`.
      properties:
        total:
          type: integer
          description: >-
            For product search with `q`, the search engine’s estimated total
            hits (may be approximate). For other list endpoints, the number of
            items in this response (same as `returned`).
        returned:
          type: integer
          description: Number of items in the `data` array in this response.
        limit:
          type: integer
          description: >-
            Applied `limit` from the request (default 100, max 5000). With `GET
            /products` and `q`, the effective value is at most 250.
        offset:
          type: integer
          description: >-
            Only when using `GET /products` with `q`: number of search hits
            skipped (pagination).
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````