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

# List Files

`GET /v1/files`

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

## Query parameters

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

## Response `200`

OK

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

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/versions/933c4ebdcd72/schema)