---
title: "List files"
method: GET
path: "/v1/files"
tags: ["File API"]
---

# List files

`GET /v1/files`

## Request

- Base URL: `https://api.writer.com`
- URL: `https://api.writer.com/v1/files`
- Auth: HTTP bearer

Retrieve a paginated list of files with optional filtering by status, graph association, and file type.

## Query parameters

- `before` string
- `after` string
- `limit` integer
- `order` 'asc' | 'desc'
- `graph_id` string, uuid
- `status` 'in_progress' | 'completed' | 'failed'
- `file_types` string

## Response `200`

- FilesResponse
  - `data` FileResponse[], required
    - `id` string, required: A unique identifier of the file.
    - `created_at` string, date-time, required: The timestamp when the file was uploaded.
    - `name` string, required: The name of the file.
    - `graph_ids` string[], required: A list of Knowledge Graph IDs that the file is associated with. If you provided a `graphId` during upload, the file is associated with that Knowledge Graph. However, the `graph_ids` field in the upload response is an empty list. The association will be visible in the `graph_ids` list when you retrieve the file using the file retrieval endpoint.
    - `status` string, required: The processing status of the file.
  - `has_more` boolean, required: Indicates if there are more files available beyond the current page.
  - `first_id` string: The ID of the first file in the current response.
  - `last_id` string: The ID of the last file in the current response.

## Changes

- **2025-07-16** `fab7a71148b6`: 1 info
  - added the new optional `query` request parameter `file_types`
- **2024-09-20** `149f74d46fcb`: 2 info
  - added the new optional `query` request parameter `status`
  - added the required property `data/items/status` to the response with the `200` status

[Operation history](https://skmtc.dev/writer/apis/writer-api/changes/v1/files/get.md)

---

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