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

# List User Files

`GET /api/v1/files/`

List uploaded files in the company the caller can see.

Owners see everything; members see files they hold a (direct or
folder-inherited) VIEWER grant on.

``include_pending=true`` also returns uploads stuck in
``parse_state='pending'`` (never finalized through the wizard) so the
files-management UI can show them with a "to finalize" badge. Defaults to
committed-only so dataset pickers reusing this endpoint are unaffected.
The accessibility filter applies to pending rows the same way.

## Query parameters

- `include_pending` boolean

## Response `200`

Successful Response

- UserFileRead[]
  - `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

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/revisions/a59877bf911b/schema)