---
title: "List video exports"
method: GET
path: "/v1/downloads"
tags: ["downloads"]
---

# List video exports

`GET /v1/downloads`

## Request

- Base URL: `https://developer.coram.ai`
- URL: `https://developer.coram.ai/v1/downloads`
- Auth: API key in header `X-Auth-Token`

Lists downloads, newest first, without files. Get a download by its id
for its links. Use `page` and `limit` to paginate; `has_more` on the
response signals more pages remain.
Requires the read:* scope and the REGULAR role. Only downloads that the
API key's creator made are listed, unless the creator is an admin.

Webhook deliveries can be lost, and a delivered webhook does not mean
the earlier ones arrived. To catch up on missed `download_finished`
events, sweep this endpoint on a schedule: set `finished_after` a few
minutes before the time your previous sweep started, read every page,
and skip download ids you have already handled. Do not use the
`finished_at` of the latest webhook you received as the cutoff, because
a download that finished earlier and whose webhook was lost would fall
before it.

## Query parameters

- `status` DownloadStatus[]
- `created_after` string, date-time
- `finished_after` string, date-time
- `page` integer
- `limit` integer

## Response `200`

One page of downloads

- DownloadList
  - `results` DownloadSummary[], required
    - `download_id` integer, required
    - `name` string, nullable, required
    - `status` 'processing' | 'ready' | 'failed' | 'cancelled' | 'expired', required
    - `failure_reason` string: Why the download failed. Set only when status is `failed`.
    - `progress_percentage` integer, required
    - `created_at` string, date-time, required
    - `finished_at` string, date-time, nullable, required: When the download stopped processing. Null while it is processing.
  - `has_more` boolean, required: True if a further page beyond `page` exists.

## Other responses

- `400`: A query parameter is invalid
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope or role
- `404`: Developer API downloads are not enabled for this organization

## Changes

- **2026-11-02** `00df3cfc762f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coram/apis/coram-api/changes/v1/downloads/get.md)

---

[API](https://skmtc.dev/coram/apis/coram-api.md) - [All operations](https://skmtc.dev/coram/apis/coram-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coram/apis/coram-api/revisions/00df3cfc762f?raw)