---
title: "List uploads"
method: GET
path: "/api/uploads"
tags: ["Uploads"]
---

# List uploads

`GET /api/uploads`

## Request

- Base URL: `https://api.zvid.io`
- URL: `https://api.zvid.io/api/uploads`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Your hosted media library — files usable directly as element `src` URLs.

## Query parameters

- `type` 'image' | 'video' | 'audio' | 'gif'

## Response `200`

Uploaded files and storage usage

- UploadList
  - `uploads` Upload[], required
    - `id` string, required
    - `kind` 'image' | 'video' | 'audio' | 'gif', required
    - `fileName` string, required
    - `mimeType` string
    - `sizeBytes` integer, required
    - `width` number, nullable
    - `height` number, nullable
    - `duration` number, nullable
    - `url` string, required
    - `createdAt` string
  - `usage` UploadUsage, required
    - `files` integer, required
    - `usedBytes` integer, required
    - `maxTotalBytes` integer, required

---

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