# List media

`GET https://api.vidmoat.com/v1/media`

- Scope: `media.read`
- Cost: Free

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, optional, default `20`): Page size, up to 100.
- `cursor` (string, optional): The `nextCursor` of the previous page.

## Response

Returns `200`.

### Response fields

- `data` (array): 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 or null): Pass as `cursor`.

## Request examples

```bash curl
curl https://api.vidmoat.com/v1/media \
  -H "Authorization: Bearer $VIDMOAT_KEY"
```

```js Node
const res = await fetch('https://api.vidmoat.com/v1/media', {
  headers: {
    Authorization: `Bearer ${process.env.VIDMOAT_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error?.message ?? `HTTP ${res.status}`);
console.log(data);
```

```python Python
import os
import requests

res = requests.get(
    "https://api.vidmoat.com/v1/media",
    headers={"Authorization": f"Bearer {os.environ['VIDMOAT_KEY']}"},
    timeout=60,
)
res.raise_for_status()
print(res.json())
```

## Example response

```json
{
  "data": [{
    "id": "cu1",
    "filename": "1727950000000-clip.mp4",
    "url": "https://api.vidmoat.com/uploads/1727950000000-clip.mp4",
    "bytes": 5242880,
    "sha256": "ab12…",
    "createdAt": "2026-10-03T12:00:00.000Z",
    "intelligence": { "status": "not_analyzed" }
  }],
  "hasMore": false,
  "nextCursor": null
}
```

---

Source: https://developer.vidmoat.com/developer/docs/api/media/list-media
Previous: [Preview a project](https://developer.vidmoat.com/developer/docs/api/renders/get-preview.md)
Next: [Upload a file](https://developer.vidmoat.com/developer/docs/api/media/upload-media.md)
All documentation: https://developer.vidmoat.com/llms-full.txt