---
title: "Returns a list of the uploaded files."
method: GET
path: "/v1/files"
tags: ["Files"]
---

# Returns a list of the uploaded files.

`GET /v1/files`

Returns a list that includes ID, file name, size, purpose, file size, and media type for the uploaded files.

## Response `200`

Successful Response.

- ListFilesResponse — Response schema for the list files API.
  - `data` MediaAsset[], required
    - `id` string, required — The file identifier (asset_id), which can be referenced in the API endpoints.
    - `path` string, required — Local path of the file or URI with optional protocol.
    - `size` integer, required — Size of the file in bytes.
    - `duration` integer — Duration of the file in nanoseconds.
    - `contentType` string, required — MIME type of the file.

## Other responses

- `500` — The invocation ended with an error.

## Changes

- **2025-05-17** `4227e796ee0b` — 1 info
  - endpoint added
- **2025-05-16** `8fa1d4aa9217` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nvidia/apis/nvidia-nim-for-vlms/changes/v1/files/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-nim-for-vlms.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-nim-for-vlms/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-nim-for-vlms/revisions/a7f196bb2b7e/schema)