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

# List files

`GET /files`

Lists files belonging to the workspace of the authenticating API key.

## Query parameters

- `limit` integer — Maximum number of files to return (1–1000).
- `cursor` string — Opaque pagination cursor from a previous response.
- `workspace_id` string, uuid — Workspace to scope the request to. Defaults to the caller’s default workspace.

## Response `200`

A page of files.

- FileListResponse — A page of files belonging to the requesting workspace.
  - `cursor` string, nullable, required — Opaque cursor for the next page; null when there are no more results.
  - `data` FileMetadata[], required
    - `created_at` string, required
    - `downloadable` boolean, required
    - `filename` string, required
    - `id` string, required
    - `mime_type` string, required
    - `size_bytes` integer, required
    - `type` 'file', required
  - `first_id` string, nullable, required
  - `has_more` boolean, required
  - `last_id` string, nullable, required

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed input
- `401` — Unauthorized - Authentication required or invalid credentials
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - Unexpected server error

---

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