---
title: "List User File Page"
method: GET
path: "/api/v1/files/page"
tags: ["files"]
---

# List User File Page

`GET /api/v1/files/page`

One folder's files, including root when folder_id is omitted.

## Query parameters

- `folder_id` string, uuid, nullable
- `include_pending` boolean
- `limit` integer
- `offset` integer
- `focus_id` string, uuid, nullable

## Response `200`

Successful Response

- UserFilePage
  - `items` UserFileRead[], required
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `user_id` string, uuid, required
    - `folder_id` string, uuid, nullable
    - `name` string, required
    - `file_type` string, required
    - `size_bytes` integer, required
    - `meta` object, required
    - `created_at` string, date-time, required
    - `parse_state` string, required
  - `total` integer, required
  - `committed_total` integer, required
  - `offset` integer, required
  - `limit` integer, required
  - `folder_counts` object, required
  - `members` DatasetMemberRead[], required
    - `source_filename` string, required
    - `user_file_id` string, required
    - `row_count` integer, required
    - `merge_error` string, nullable
    - `merge_warning` string, nullable
    - `superseded_at` string, nullable
    - `last_refreshed_at` string, required
    - `batch_key` string, nullable
    - `created_at` string

## Other responses

- `422` — Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-29** `77d4fd215b57` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/files/page/get.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) · [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/77d4fd215b57?raw)