> ## 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 archivos subidos
> GET /media/
Lista los archivos subidos propios de la cuenta, en el host de la **API de gestión** (`api.scanova.io`), autenticado con su clave de API de gestión sin procesar.
```
GET https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Filtra por tipo de archivo detectado, p. ej. `png`.
Filtra por indicador de uso, p. ej. `qr_logo`.
Filtra por extensión de archivo.
Filtra por tipo MIME.
Filtra archivos que (no) forman parte de un lote de medios masivos.
Busca en `original_name`.
Ordena por `created`, `original_name` o `file_size` — anteponga `-` para orden descendente. El valor predeterminado es `-created`.
Lista separada por comas de campos permitidos, para reducir la forma de la respuesta.
Número de página.
Resultados por página, máximo 100.
```bash cURL theme={null}
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
```
```json 200 theme={null}
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
```
Este endpoint no rechaza directamente las llamadas no autenticadas — una clave de API ausente o inválida simplemente restringe la consulta a ningún usuario, por lo que obtendrá un conjunto de resultados vacío en lugar de un `401`. Envíe siempre su clave.
## Relacionado
* [Subir un archivo](/es/api-reference/management-api/user-media/upload) — añadir uno nuevo.
* [Listar tipos de archivo permitidos](/es/api-reference/management-api/user-media/allowed-files) — las restricciones que deben cumplir las subidas.
* [Obtener un archivo](/es/api-reference/management-api/user-media/retrieve) — obtener uno por id.
* [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 /media/
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:
/media/:
get:
summary: List uploaded files
description: >-
The account's own uploaded files. Supports filtering by file_type,
in_use, extension, mime_type, and is_bulk; searching by original_name;
and ordering by created, original_name, or file_size.
operationId: listMedia
parameters:
- name: file_type
in: query
required: false
schema:
type: string
- name: in_use
in: query
required: false
schema:
type: string
- name: extension
in: query
required: false
schema:
type: string
- name: mime_type
in: query
required: false
schema:
type: string
- name: is_bulk
in: query
required: false
schema:
type: boolean
- name: search
in: query
required: false
schema:
type: string
- name: ordering
in: query
required: false
schema:
type: string
description: e.g. -created, original_name, file_size.
- name: fields
in: query
required: false
schema:
type: string
description: Comma-separated field allow-list for the response.
- name: page
in: query
required: false
schema:
type: integer
- name: page_size
in: query
required: false
schema:
type: integer
description: Max 100.
responses:
'200':
description: Paginated list of files.
content:
application/json:
example:
count: 1
next: null
previous: null
results:
- id: 4821
file: media/uploads/104/2026/09/20260908_512873_logo.png
upload: null
file_name: 20260908_512873_logo.png
size: 48213
human_readable_size: 47.08 KB
original_name: logo.png
bulk_media: null
mime_type: image/png
file_type: png
in_use: qr_logo
category: custom-design
created: '2026-09-08T10:15:32.120Z'
modified: '2026-09-08T10:15:32.120Z'
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.
````