---
title: "Get Run By Id"
method: GET
path: "/run"
tags: ["run"]
---

# Get Run By Id

`GET /run`

## Query parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- RunsWithDocuments
  - `run_id` string, uuid, required
  - `run_time` string, date-time, required
  - `company_id` string, uuid, required
  - `vendor_id` string, uuid, required
  - `results` union, required
    - ContractResult
      - `clause_version` integer, required
      - `summary_version` integer, required
      - `type` string
    - MarketingResult
      - `type` string
      - `documents` unknown, required
    - SOCResult
      - `version` integer, nullable
      - `soc_2_analysis` unknown, required
    - SOC1Result
      - `version` integer, required
      - `soc_1_analysis` unknown, required
    - DraftingResult
      - `version` integer, required
      - `content` union, required
        - string
        - object[]
      - `has_citations` boolean
      - `warning` string, nullable
    - MainResult
      - `clauses` unknown
      - `documents` unknown, required
    - InherentRiskAssessmentResult
      - `version` integer, required
      - `suggested_risk_level` RiskLevelField, required
        - `label` string, required
        - `hex_color` string, nullable, required
        - `option_id` string, required
        - `order_index` integer, required
      - `rationale` string, required
      - `form_request_id` string, nullable
      - `form_response_id` string, nullable
      - `service_id` string, nullable
    - PendingResult
      - `status` string
    - FailedResult
      - `status` string
    - DraftingV3RunResults
      - `version` integer
      - `template_name` string, required
      - `template_id` string
      - `warning` string, nullable
      - `content` QuestionnaireSection[], required
        - `section_name` string, required
        - `responses` union[], required
          - union
            - QuestionnaireAnswerChoiceAnswer
              - …
            - QuestionnaireAnswerFreeAnswer
              - …
      - `has_citations` boolean
    - RiskAssessmentRunResult
      - `version` integer
      - `drafting_result` DraftingV3RunResults, required
        - `version` integer
        - `template_name` string, required
        - `template_id` string
        - `warning` string, nullable
        - `content` QuestionnaireSection[], required
          - `section_name` string, required
          - `responses` union[], required
            - union
              - …
        - `has_citations` boolean
      - `assessed_risk_level` RiskLevelField
        - `label` string, required
        - `hex_color` string, nullable, required
        - `option_id` string, required
        - `order_index` integer, required
      - `possible_risk_levels` RiskLevelField[] — Enumerated possible risk levels
        - `label` string, required
        - `hex_color` string, nullable, required
        - `option_id` string, required
        - `order_index` integer, required
      - `rationale` string, required — Rationale for the assessed risk level
  - `program_type` ProgramType[], nullable
  - `marketing_program_type` MarketingProgramType[], nullable
  - `run_type` 'base' | 'soc' | 'soc1' | 'marketing' | 'overview' | 'contract_analysis' | 'drafting' | 'inherent_risk_assessment' | 'risk_assessment', required
  - `status` 'archived' | 'available' | 'deleted' | 'pending' | 'failed'
  - `exported_pdf_filename` string, nullable
  - `notes` unknown
  - `documents` FileVersions[], required
    - `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
  - `user_first_name` string, nullable
  - `user_last_name` 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/425d5b8a3c17/schema)