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

# List Files

`GET /v1/files/list`

## Request

- Base URL: `https://api.minimax.io`
- URL: `https://api.minimax.io/v1/files/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/minimax/apis/minimax-api-2/docs/v1/files/list/get.ts> (a function with typed inputs; its response is checked against the schema)

List files with optional filtering and pagination

## Query parameters

- `GroupId` string, required
- `purpose` 'fine-tune' | 'assistants' | 'batch' | 'vision'
- `page` integer
- `size` integer
- `after_file_id` integer

## Response `200`

Successful response

- ListFileResp
  - `files` FileObject[]: List of files
    - `id` string: File ID
    - `object` 'file': Object type
    - `bytes` integer: File size in bytes
    - `created_at` integer: Unix timestamp of file creation
    - `filename` string: Original filename
    - `purpose` 'fine-tune' | 'assistants' | 'batch' | 'vision': Purpose of the file
    - `status` 'uploaded' | 'processing' | 'processed' | 'error': File processing status

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/minimax/apis/minimax-api-2.md) - [All operations](https://skmtc.dev/minimax/apis/minimax-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/minimax/apis/minimax-api-2/revisions/b18c2ab45c0e?raw)