---
title: "Get Vendor Documents Health"
method: GET
path: "/files/vendor/health"
tags: ["files"]
---

# Get Vendor Documents Health

`GET /files/vendor/health`

Return file stacks for all vendor documents, with extraction data when available.

## Query parameters

- `vendor_id` string, uuid, required

## Response `200`

Successful Response

- VendorDocumentHealthResponse
  - `stacks` HealthFileStack[], required
    - `file_id` string, uuid, required
    - `document_type` string, required
    - `document_type_label` string, required
    - `project_id` string, uuid, nullable
    - `versions` HealthFileVersion[], required
      - `upload_id` string, uuid, required
      - `filename` string, required
      - `uploaded_at` string, date-time, required
      - `uploaded_by` UserResponse
        - `user_id` string, uuid, required
        - `user_first_name` string, required
        - `user_last_name` string, required
        - `email_address` string, required
        - `company_id` string, uuid, required
        - `profile_picture_url` string, nullable
        - `masquerade_status` MasqueradeStatus
          - `mode` 'soft' | 'hard', required
          - `target_company_id` string, uuid, required
          - `target_company_name` string, required
        - `whats_new_last_viewed_at` string, date-time, nullable
      - `expiration_date` string, date, nullable
      - `processing_status` 'processing' | 'deleted' | 'in_use' | 'in_progress' | 'failed' | 'processing_skipped'
      - `failure_reason` string, nullable
      - `smart_document_type` 'soc' | 'contract' | 'pen_test' | 'coi' | 'dpa' | 'bcp' | 'iso_27001' | 'infosec_policy' | 'financial_statements' | 'subprocessor_list' | 'pci_aoc'
      - `agent_run_id` string, uuid, nullable
      - `agent_run_status` 'pending' | 'running' | 'completed' | 'failed'
      - `requirements_processing` boolean
      - `requirements_worst_compliance` 'compliant' | 'non_compliant' | 'partially_compliant' | 'no_evidence' | 'not_applicable' — Compliance status for an evidence requirement.
      - `regulatory_review_processing` boolean
      - `regulatory_review_worst_severity` 'low' | 'medium' | 'high'
      - `field_groups` FieldGroup[]
        - `id` string, required
        - `label` string, required
        - `fields` Field[], required
          - `id` string, required
          - `label` string, required
          - `value` union, required
            - FieldValueText
              - …
            - FieldValueDate
              - …
            - FieldValueNumber
              - …
            - FieldValueMoney
              - …
            - FieldValueYesNo
              - …
            - FieldValueList
              - …
            - FieldValueMultiline
              - …
          - `citations` BackendModelsPydanticFieldGroupsCitation[]
            - `page` integer, required
            - `content` string, required
  - `folders` HealthFolder[]
    - `folder_id` string, uuid, required
    - `folder_name` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-04** `816d6dca5096` — 1 warning
  - added the new `processing_skipped` enum value to the `stacks/items/versions/items/processing_status/anyOf[subschema #1: UploadedFileStatus]/` response property for the response status `200`

[Change history](https://skmtc.dev/kobaltlabs/apis/fastapi/changes/files/vendor/health/get.md)

---

[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/816d6dca5096/schema)