---
title: "List media"
method: GET
path: "/media"
tags: ["Media"]
---

# List media

`GET /media`

## Request

- Base URL: `https://api.vidmoat.com/v1`
- URL: `https://api.vidmoat.com/v1/media`
- Auth: HTTP bearer

List the files uploaded or imported on the account, newest first, with the URLs a clip `src` can point at. Generated media is not included.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

List media

- object
  - `data` object[]: Files.
    - `id` string: File id.
    - `filename` string: Stored name.
    - `url` string: Use as a clip `src`.
    - `bytes` integer: Size.
    - `sha256` string: Content hash.
    - `createdAt` string: ISO 8601 time.
    - `intelligence` object: Footage analysis: `status` (`not_analyzed`, `pending`, `failed`, `ready` or `unavailable`) and, when ready, a `summary`.
  - `hasMore` boolean: Another page exists.
  - `nextCursor` string, nullable: Pass as `cursor`.

---

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