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

# Kategorievorlagen auflisten

> GET /qr-assets/category-template/

Listet den gemeinsamen Katalog vordefinierter Designvorlagen pro QR-Kategorie auf, auf dem **Management-API**-Host (`api.scanova.io`).

```
GET https://api.scanova.io/qr-assets/category-template/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<Warning>
  Dieser Endpunkt erfordert keinen Management-API-Schlüssel — er ist absichtlich für anonyme Aufrufer offen (Gastzugriff auf die Vorlagengalerie des Publish Panels). Der Datensatz ist ein gemeinsamer, nicht personalisierter Katalog, der keinem Konto zugeordnet ist, sodass es hier nichts Benutzerspezifisches zu schützen gibt.
</Warning>

<ParamField query="category_slug" type="string">
  Filtert auf Vorlagen für eine QR-Kategorie, z. B. `website-url`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/qr-assets/category-template/?category_slug=website-url"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": 21,
      "name": "Ocean Blue",
      "template_id": "cat-tpl-21",
      "category_slug": "website-url",
      "pattern_info": "{\"dotStyle\":\"round\"}",
      "image": "https://cdn.scanova.io/upload/category-templates/21.png",
      "created": "2026-01-15T08:00:00Z"
    }
  ]
  ```
</ResponseExample>

## Nicht paginiert

Die Antwort ist ein einfaches JSON-Array, nicht die übliche `{count, next, previous, results}`-Hülle, die jeder andere Listen-Endpunkt dieses Moduls verwendet — die vollständige passende Menge wird in einer Antwort zurückgegeben.

## Verwandte Themen

* [QR-Code-Designvorlagen auflisten](/de/api-reference/management-api/qr-assets/template-list) — das kontobezogene Äquivalent, das paginiert.
* [Übersicht über die Management API](/de/api-reference/management-api/overview) — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /qr-assets/category-template/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /qr-assets/category-template/:
    get:
      summary: List category templates
      description: >-
        A shared, non-personalized catalog of predefined design templates per QR
        category — not scoped to any user, and readable without a Management API
        key (guest Publish Panel access). Pagination is disabled: the full
        matching set is returned in one response, not the usual `{count, next,
        previous, results}` envelope.
      operationId: listCategoryTemplates
      parameters:
        - name: category_slug
          in: query
          required: false
          schema:
            type: string
          description: Filter to templates for one QR category, e.g. `website-url`.
      responses:
        '200':
          description: Plain array of category templates (no pagination envelope).
          content:
            application/json:
              example:
                - id: 21
                  name: Ocean Blue
                  template_id: cat-tpl-21
                  category_slug: website-url
                  pattern_info: '{"dotStyle":"round"}'
                  image: https://cdn.scanova.io/upload/category-templates/21.png
                  created: '2026-01-15T08:00:00Z'
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````