---
title: "Get Files"
method: GET
path: "/v1/files"
tags: ["files"]
---

# Get Files

`GET /v1/files`

## Request

- Base URL: `https://api.vlm.run` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vlm.run/v1/files`
- Auth: HTTP bearer

Get all files uploaded by the user with pagination.

## Query parameters

- `skip` integer: Number of items to skip
- `limit` integer, nullable: Maximum number of items to return

## Response `200`

Successful Response

- StoreFileResponse[]
  - `id` string, nullable: Unique identifier of the file
  - `filename` string, nullable, required: Name of the file
  - `bytes` integer, required: Size of the file in bytes
  - `purpose` 'assistants' | 'batch' | 'fine-tune' | 'vision' | 'datasets', required: Purpose of the file
  - `created_at` string, date-time: Date and time when the file was created (in UTC timezone)
  - `object` 'file': Type of the file
  - `public_url` string, nullable: Presigned URL of the file

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vlm/apis/vlm-run-unified-server.md) · [All operations](https://skmtc.dev/vlm/apis/vlm-run-unified-server/llms.txt) · [OpenAPI document](https://skmtc.dev/vlm/apis/vlm-run-unified-server/revisions/4a68ab36546b?raw)