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

# List Files

`GET /api/v1/files`

List all uploaded files for the team.

Supports pagination with limit and offset parameters.

Args:
    limit: Maximum number of files to return (default: 50, max: 100)
    offset: Number of files to skip (default: 0)

## Query parameters

- `limit` integer
- `offset` integer

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Response `200`

Successful Response

- ListFilesResponse — Response with list of files.
  - `files` FileMetadataResponse[], required — List of uploaded files
    - `file_id` integer, required — Unique file ID
    - `original_filename` string, required — Original filename
    - `content_type` string, required — MIME type
    - `file_size` integer, required — File size in bytes
    - `upload_status` string, required — Upload status: pending, completed, or failed
    - `created` string, date-time, required — Upload timestamp
    - `reference` string, required — File reference in datalab://file-{id} format
  - `total` integer, required — Total number of files
  - `limit` integer, required — Limit per page
  - `offset` integer, required — Current offset

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/datalab/apis/datalab-api.md) · [All operations](https://skmtc.dev/datalab/apis/datalab-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datalab/datalab-api/revisions/aa9f8ee18efb/schema)