> ## 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.
# QR-Codes auflisten
> GET /qr/
Listet QR-Codes auf oder erstellt sie auf dem **Management-API**-Host (`management.scanova.io`), authentifiziert mit Ihrem rohen Management-API-Schlüssel — siehe die [Übersicht](/de/api-reference/management-api/overview), falls Sie das noch nicht eingerichtet haben.
```
GET https://management.scanova.io/qr/
POST https://management.scanova.io/qr/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
`GET /qr/` gibt eine paginierte, filterbare Liste der QR-Codes zurück, die dem Konto gehören, zu dem der Schlüssel gehört.
### Query-Parameter
Freitextsuche über QR-Name, `qrid`, dynamischen URL-Slug und Ordnername.
Kommagetrennte Kategorie-Slugs, z. B. `url,event`. Trifft auf jede der aufgeführten Kategorien zu.
Kommagetrennte Tag-Namen. Trifft auf jeden der aufgeführten Tags zu.
Kommagetrennte QR-Typen: `dy` (Dynamisch), `st` (Statisch).
Ordner-ID — gibt nur QR-Codes in diesem Ordner zurück.
ISO-Datum. Gibt QR-Codes zurück, die an oder nach diesem Datum erstellt wurden.
ISO-Datum. Gibt QR-Codes zurück, die an oder vor diesem Datum erstellt wurden.
Eines oder mehrere von `name`, `created`, `qr_type`, `category__name`, kommagetrennt. Stellen Sie einem Feld ein `-` voran, um absteigend zu sortieren, z. B. `ordering=-created`.
Seitenzahl.
Ergebnisse pro Seite, bis zu einem Maximum von `100`.
```json 200 OK theme={null}
{
"count": 214,
"next": 2,
"previous": null,
"results": [
{
"id": 88231,
"qrid": "QR7K9M2XN",
"name": "Product launch flyer",
"qr_type": "dy",
"qr_type_display": "Dynamic",
"category": {
"id": 1,
"name": "Website URL",
"slug": "url",
"description": "Link a QR code straight to any website.",
"preview_image": "https://cdn.scanova.io/categories/url.png",
"allowed_qr_types": ["dy", "st"],
"allowed_qr_types_display": ["Dynamic", "Static"],
"is_active": true
},
"dynamic_url_object": {
"url_hash": "a1b2c3",
"complete_url": "https://qr.link/a1b2c3",
"visit_count": 1042
},
"thumbnail": "https://cdn.scanova.io/thumbnails/QR7K9M2XN.png",
"is_active": true,
"folder": null,
"created": "2026-06-02T14:03:11Z",
"modified": "2026-08-10T08:41:02Z",
"tags_list": ["campaign-2026", "print"],
"is_password_protected": false,
"is_age_restricted": false,
"created_by": { "full_name": "Jordan Lee" },
"published_at": "2026-06-02T14:05:00Z",
"is_currently_draft": false
}
]
}
```
`next` und `previous` sind **Seitenzahlen** (oder `null`), keine vollständigen URLs — die Paginierung dieser API unterscheidet sich in dieser Hinsicht von der einfachen `PageNumberPagination` von DRF. Rufen Sie die nächste Seite mit `?page=2` ab, nicht indem Sie einer URL aus der Antwort folgen.
`category` ist das vollständige Kategorie-Objekt — die oben gezeigten Felder sind eine repräsentative Teilmenge; dasselbe Objekt enthält außerdem `tags`, `is_new`, `has_landing_page`, `helpdesk_link`, `qr_name_pattern`, `created` und `modified`. `dynamic_url_object` ist nur bei dynamischen (`dy`) QR-Codes vorhanden.
## Verwandte Themen
* [Einen QR-Code erstellen](/de/api-reference/management-api/qr/create) — die andere Operation an diesem selben Endpunkt.
* [Abrufen](/de/api-reference/management-api/qr/retrieve) — mit einem einzelnen QR-Code arbeiten, der von dieser Liste zurückgegeben wird.
* [Aktualisieren](/de/api-reference/management-api/qr/update) — mit einem einzelnen QR-Code arbeiten, der von dieser Liste zurückgegeben wird.
* [Löschen](/de/api-reference/management-api/qr/delete) — mit einem einzelnen QR-Code arbeiten, der von dieser Liste zurückgegeben wird.
* [Ein QR-Code-Bild herunterladen](/de/api-reference/management-api/qr/download) — rendern Sie einen dieser QR-Codes als PNG/SVG/PDF/etc.
* [Gelöschte QR-Codes auflisten](/de/api-reference/management-api/qr/trash) — wohin ein QR-Code nach dem Löschen aus dieser Liste wandert.
* [Management-API-Übersicht](/de/api-reference/management-api/overview) — das Auth-Schema und die Quota-Regeln, die für diesen Endpunkt gelten.
## OpenAPI
````yaml api-reference/openapi/management-api.json GET /qr/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
management.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://management.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/qr/:
get:
summary: List QR codes
operationId: listManagedQrCodes
responses:
'200':
description: List of QR codes
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. management.scanova.io) — the same key sent to
the regular API host will not authenticate.
````