> ## 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.

# Lieferanten auflisten

> Alle Lieferanten Ihrer Organisation abrufen

Optional **`limit`** (1–5000, Standard 100) begrenzt die Anzahl der Lieferanten. Die Antwort-**`meta`** enthält `total`, `returned` und `limit`. Siehe [Einführung](/api-reference/de/introduction#listen-antworten-meta).


## OpenAPI

````yaml GET /suppliers
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:
  /suppliers:
    get:
      tags:
        - Suppliers
      summary: List suppliers
      description: >-
        Returns suppliers of an organization, up to `limit` (default 100, max
        5000). The response includes `meta` (`ListMeta`) with `total`,
        `returned`, and `limit` (length of `data` matches `returned`).
      operationId: listSuppliers
      parameters:
        - name: limit
          in: query
          required: false
          description: Maximum number of suppliers to return. Integer 1–5000. Default 100.
          schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 100
      responses:
        '200':
          description: List of suppliers with `meta`.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Supplier'
                  meta:
                    $ref: '#/components/schemas/ListMeta'
              example:
                data:
                  - id: sup_01
                    name: Example supplier
                    description: ''
                meta:
                  total: 1
                  returned: 1
                  limit: 100
components:
  schemas:
    Supplier:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          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

````