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

# List Files By Type

`GET /files`

List files filtered by file_type for dropdowns and selectors.

When ``internal_only`` is set, only company-owned (non-vendor) files are
returned (e.g. internal policies usable for requirement extraction).

## Query parameters

- `file_type` string, nullable
- `internal_only` boolean

## Response `200`

Successful Response

- FileVersions[]
  - `upload_id` string, uuid, required
  - `file_id` string, uuid, required
  - `filename` string, required
  - `created` string, date-time, required
  - `review_status` 'approved' | 'review_in_progress' | 'needs_remediation'
  - `aws_key` string, nullable
  - `vendor_id` string, uuid, nullable
  - `status` 'processing' | 'deleted' | 'in_use' | 'in_progress' | 'failed'
  - `collateral_type` 'Agent Call Flow' | 'Audio' | 'Billboard' | 'Communications' | 'Conversation Design' | 'Email' | 'Help Center Article' | 'In-App' | 'Mailer' | 'Organic Social' | 'Paid Advertising' | 'Paid Search' | 'Paid Social' | 'Press Release' | 'Procedure/Decision Tree' | 'Support Agent Training' | 'TV' | 'Web' | 'Wiki' | 'Other'
  - `transcript_from_video` boolean, nullable
  - `preset_ids` string[], nullable
  - `failure_reason` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/fastapi.md) · [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kobaltlabs/fastapi/revisions/3ff4c0bd276b/schema)