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

# List Files

`GET /v3/upload`

## Request

- Base URL: `https://api.edenai.run`
- URL: `https://api.edenai.run/v3/upload`
- Auth: HTTP bearer

List uploaded files for the authenticated user.

Optionally filter by purpose. Only returns non-expired files.
Results are ordered by creation date (newest first).

## Query parameters

- `purpose` string, nullable: Filter by purpose
- `page` integer: Page number (1-indexed)
- `limit` integer: Maximum number of items per page

## Response `200`

Successful Response

- ListFilesResponse: Response for listing files with pagination.
  - `items` FileResponse[], required: List of items
    - `file_id` string, uuid, required: Unique file identifier for use in API calls
    - `file_name` string, required: Original filename
    - `file_size` integer, required: File size in bytes
    - `file_mimetype` string, required: Detected MIME type
    - `purpose` string, required: Purpose of the file (e.g., 'general', 'assistants')
    - `metadata` object: File metadata (e.g., page_count for PDFs/documents)
    - `created_at` string, date-time, required: Upload timestamp
    - `expires_at` string, date-time, nullable: Expiration timestamp
  - `total` integer, required: Total number of items
  - `page` integer, required: Current page number
  - `limit` integer, required: Items per page
  - `total_pages` integer, required: Total number of pages

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/edenai/apis/eden-ai-api-v3.md) - [All operations](https://skmtc.dev/edenai/apis/eden-ai-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/edenai/apis/eden-ai-api-v3/revisions/20ddfd49a3f4?raw)