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

# List Files

`GET /files`

Lists files for the authenticated user with cursor-based pagination and optional filtering by date range.

## Query parameters

- `limit` integer
- `cursor` string, date-time
- `start` string, date-time
- `end` string, date-time
- `sort` 'asc' | 'desc'

## Response `200`

Paginated list of files

- FilesResponse
  - `files` FileResponse[], required — List of files
    - `content_type` string, required — MIME type detected or provided for the file.
    - `created_at` string, date-time, required — Timestamp when the file was created.
    - `file_id` string, required — Unique identifier for the file.
    - `file_name` string, required — The original filename supplied by the client.
    - `file_size` integer, required — Size of the stored file in bytes.
    - `metadata` object, required — Arbitrary JSON metadata associated with the file.
    - `url` string, required — Permanent Chunkr URL. Use directly with other chunkr API requests.
  - `has_more` boolean, required — Whether there are more files to fetch
  - `next_cursor` string, date-time, nullable — Cursor for pagination (timestamp) e.g. 2025-01-01T00:00:00Z

## Other responses

- `401` — Unauthorized
- `500` — Server error

---

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