> ## 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.
# Lister les QR codes
> GET /qr/
Liste ou crée des QR codes sur l'hôte **Management API** (`management.scanova.io`), authentifié avec votre clé Management API brute — voir la [vue d'ensemble](/fr/api-reference/management-api/overview) si vous ne l'avez pas encore configurée.
```
GET https://management.scanova.io/qr/
POST https://management.scanova.io/qr/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
`GET /qr/` renvoie une liste paginée et filtrable des QR codes appartenant au compte auquel appartient la clé.
### Paramètres de requête
Recherche en texte libre sur le nom du QR code, le `qrid`, le slug de l'URL dynamique et le nom du dossier.
Slugs de catégorie séparés par des virgules, par ex. `url,event`. Correspond à n'importe laquelle des catégories listées.
Noms de tags séparés par des virgules. Correspond à n'importe lequel des tags listés.
Types de QR code séparés par des virgules : `dy` (Dynamique), `st` (Statique).
ID de dossier — renvoie uniquement les QR codes de ce dossier.
Date ISO. Renvoie les QR codes créés à cette date ou après.
Date ISO. Renvoie les QR codes créés à cette date ou avant.
Un ou plusieurs de `name`, `created`, `qr_type`, `category__name`, séparés par des virgules. Préfixez un champ de `-` pour un tri descendant, par ex. `ordering=-created`.
Numéro de page.
Résultats par page, jusqu'à un maximum de `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` et `previous` sont des **numéros de page** (ou `null`), pas des URL complètes — la pagination de cette API diffère à cet égard de la `PageNumberPagination` DRF classique. Récupérez la page suivante avec `?page=2`, et non en suivant une URL de la réponse.
`category` est l'objet catégorie complet — les champs montrés ci-dessus sont un sous-ensemble représentatif ; ce même objet porte aussi `tags`, `is_new`, `has_landing_page`, `helpdesk_link`, `qr_name_pattern`, `created` et `modified`. `dynamic_url_object` n'est présent que pour les QR codes Dynamiques (`dy`).
## Voir aussi
* [Créer un QR code](/fr/api-reference/management-api/qr/create) — l'autre opération de ce même endpoint.
* [Récupérer](/fr/api-reference/management-api/qr/retrieve) — opérez sur un QR code unique renvoyé par cette liste.
* [Mettre à jour](/fr/api-reference/management-api/qr/update) — opérez sur un QR code unique renvoyé par cette liste.
* [Supprimer](/fr/api-reference/management-api/qr/delete) — opérez sur un QR code unique renvoyé par cette liste.
* [Télécharger l'image d'un QR code](/fr/api-reference/management-api/qr/download) — générez l'un de ces QR codes en PNG/SVG/PDF/etc.
* [Lister les QR codes dans la corbeille](/fr/api-reference/management-api/qr/trash) — où va un QR code après avoir été supprimé de cette liste.
* [Vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quotas qui s'appliquent à cet endpoint.
## 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.
````