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

# List Files

`GET /files`

Returns a list of files that belong to the user's organization.

## Query parameters

- `page` integer
- `page_size` integer
- `sample_type` SampleType[], nullable
- `source` Source[], nullable
- `search` string, nullable
- `purpose` 'fine-tune' | 'batch'

## Response `200`

OK

- ListFilesOut
  - `total` integer, required
  - `data` FileSchema[], required
    - `filename` string, required — The name of the uploaded file.
    - `purpose` 'fine-tune' | 'batch', required
    - `bytes` integer, required — The size of the file, in bytes.
    - `created_at` integer, required — The UNIX timestamp (in seconds) of the event.
    - `id` string, uuid, required — The unique identifier of the file.
    - `source` 'upload' | 'repository' | 'mistral', required
    - `sample_type` 'pretrain' | 'instruct' | 'batch_request' | 'batch_result' | 'batch_error', required
    - `num_lines` integer, nullable
    - `object` string, required — The object type, which is always "file".
  - `object` string, required

## Changes

- **2026-07-17** `062746a4d99e` — 1 info
  - endpoint added
- **2025-03-09** `a88399f645b2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ballerina-platform/apis/mistral-ai-api/changes/files/get.md)

---

[API](https://skmtc.dev/ballerina-platform/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/ballerina-platform/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ballerina-platform/mistral-ai-api/revisions/062746a4d99e/schema)