> ## 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.
# Listar códigos QR
> GET /qr/
Lista o crea códigos QR en el host de la **API de gestión** (`management.scanova.io`), autenticado con tu clave sin procesar de la API de gestión — consulta el [resumen](/es/api-reference/management-api/overview) si aún no has configurado esto.
```
GET https://management.scanova.io/qr/
POST https://management.scanova.io/qr/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
`GET /qr/` devuelve una lista paginada y filtrable de los códigos QR propiedad de la cuenta a la que pertenece la clave.
### Parámetros de consulta
Búsqueda de texto libre en el nombre del QR, `qrid`, el slug de URL dinámica y el nombre de la carpeta.
Slugs de categoría separados por comas, p. ej. `url,event`. Coincide con cualquiera de las categorías indicadas.
Nombres de etiquetas separados por comas. Coincide con cualquiera de las etiquetas indicadas.
Tipos de QR separados por comas: `dy` (Dinámico), `st` (Estático).
ID de carpeta — devuelve solo los códigos QR de esa carpeta.
Fecha ISO. Devuelve códigos QR creados en o después de esta fecha.
Fecha ISO. Devuelve códigos QR creados en o antes de esta fecha.
Uno o más de `name`, `created`, `qr_type`, `category__name`, separados por comas. Antepón `-` a un campo para ordenar de forma descendente, p. ej. `ordering=-created`.
Número de página.
Resultados por página, hasta un máximo 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` y `previous` son **números de página** (o `null`), no URLs completas — la paginación de esta API difiere en ese aspecto de la `PageNumberPagination` estándar de DRF. Obtén la página siguiente con `?page=2`, no siguiendo una URL de la respuesta.
`category` es el objeto de categoría completo — los campos mostrados arriba son un subconjunto representativo; el mismo objeto también incluye `tags`, `is_new`, `has_landing_page`, `helpdesk_link`, `qr_name_pattern`, `created` y `modified`. `dynamic_url_object` solo está presente para códigos QR Dinámicos (`dy`).
## Relacionado
* [Crear un código QR](/es/api-reference/management-api/qr/create) — la otra operación de este mismo endpoint.
* [Obtener](/es/api-reference/management-api/qr/retrieve) — opera sobre un único código QR devuelto por esta lista.
* [Actualizar](/es/api-reference/management-api/qr/update) — opera sobre un único código QR devuelto por esta lista.
* [Eliminar](/es/api-reference/management-api/qr/delete) — opera sobre un único código QR devuelto por esta lista.
* [Descargar la imagen de un código QR](/es/api-reference/management-api/qr/download) — renderiza uno de estos códigos QR como PNG/SVG/PDF/etc.
* [Listar códigos QR en la papelera](/es/api-reference/management-api/qr/trash) — a dónde va un código QR después de eliminarse de esta lista.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y las reglas de cuota que se aplican a este 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.
````