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

# List files

`GET /v1beta/files`

## Request

- Base URL: `https://api.indices.io`
- URL: `https://api.indices.io/v1beta/files`
- Auth: HTTP bearer

List your files: uploads and run outputs. Default order is newest first.

## Query parameters

- `run_id` string: Only files produced by this run.
- `connector_id` string: Only files produced by runs of this connector.
- `filename` string: Only files whose name contains this text.
- `source` 'UPLOAD' | 'RUN_OUTPUT'
- `sort` 'name' | 'created_at' | 'size_bytes' | 'source'
- `order` 'asc' | 'desc'
- `limit` integer: Maximum number of files to return.
- `cursor` string: Cursor from a previous response's `next_cursor`, to fetch the next page.

## Response `200`

Successful response

- ListFilesResponse
  - `data` File[], required: Files for the requested page.
    - `id` string, required: Unique identifier for the object.
    - `source` 'UPLOAD' | 'RUN_OUTPUT', required
    - `run_id` string, nullable, required: ID of the run that produced this file. Null for uploaded files.
    - `name` string, required: User-facing filename.
    - `size_bytes` integer, required: Size of the file in bytes.
    - `content_type` string, required: MIME type of the file.
    - `crc32c` string, required: Base64-encoded CRC32C checksum of the file content.
    - `created_at` string, date-time, required: Timestamp when the file was created.
  - `has_more` boolean, required: Whether more files exist after this page.
  - `next_cursor` string, nullable, required: Pass as the `cursor` query parameter to fetch the next page. Null when has_more is false.

## Other responses

- `422`: Validation error

---

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