---
title: "List active and recently finished URL downloads."
method: GET
path: "/api/media/downloads"
tags: ["Media"]
---

# List active and recently finished URL downloads.

`GET /api/media/downloads`

## Request

- The document declares no server URL.
- Auth: none declared

## Response `200`

Downloads, oldest first

- MediaDownloadListResponse: Response listing active and recently finished URL downloads.
  - `downloads` MediaDownloadJob[], required: Downloads, oldest first.
    - `bytes` integer, required: Bytes received so far.
    - `directory` string, required: Directory the file is saved into, relative to the media root.
    - `error` string, nullable: Why the download failed, when it did.
    - `filename` string, required: File name the download is saved as.
    - `job_id` string, required: Job identifier, used to cancel the download.
    - `path` string, required: Path of the finished file, relative to the media root.
    - `state` 'downloading' | 'done' | 'failed' | 'cancelled', required: Where a URL download is in its life.
    - `total` integer, nullable: Total size, when the server announced one.
    - `url` string, required: The requested URL without user info, query or fragment, for display.

## Changes

- **2026-10-08** `4ab7568b68c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/eyevinn/apis/strom-api/changes/api/media/downloads/get.md)

---

[API](https://skmtc.dev/eyevinn/apis/strom-api.md) - [All operations](https://skmtc.dev/eyevinn/apis/strom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eyevinn/apis/strom-api/revisions/8cd4dbc44175?raw)