---
title: "Get Files For Vendor"
method: GET
path: "/files/vendor"
tags: ["files"]
---

# Get Files For Vendor

`GET /files/vendor`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/files/vendor`
- Auth: none declared

## Query parameters

- `vendor_id` string, uuid, nullable
- `file_types` string[], nullable
- `excluded_file_types` string[], nullable
- `show_archived` boolean
- `marketing_team_id` string, uuid, nullable
- `include_risks` boolean

## Response `200`

Successful Response

- UploadedFilesCollectionWithAssignees
  - `files` UploadedFilesResponse[], required
    - `file_id` string, uuid, required
    - `file_type` string, required
    - `filename` string, required
    - `vendor_id` string, uuid, nullable
    - `created` string, date-time, required
    - `modified` string, date-time, nullable
    - `aws_key` string, nullable
    - `num_pages` integer, nullable
    - `project_id` string, uuid, nullable
    - `document_request_id` string, uuid, nullable
    - `uploaded_by` string, uuid, nullable
    - `upload_id` string, uuid, nullable
    - `review_status` string, nullable
    - `has_risks` boolean
    - `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
    - `embed_state` 'COMPLETED' | 'IN_PROGRESS' | 'NOT_STARTED' | 'FAILED' | 'NOT_SUPPORTED' | 'CLEANUP_IN_PROGRESS'
    - `size_bytes` integer, nullable
    - `status` 'processing' | 'deleted' | 'in_use' | 'in_progress' | 'failed' | 'processing_skipped'
    - `is_kobalt_generated` boolean
  - `folders` object, required
  - `file_assignees` object, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-04** `816d6dca5096`: 2 warning
  - added the new `processing_skipped` enum value to the `files/items/status/anyOf[subschema #1: UploadedFileStatus]/` response property for the response status `200`
  - added the new `processing_skipped` enum value to the `folders/additionalProperties/prefixItems[subschema #2]/items/status/anyOf[subschema #1: UploadedFileStatus]/` response property for the response status `200`

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

---

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