---
title: "Get Collateral Analysis History"
method: GET
path: "/marketing/collateral/{file_id}/analysis-history"
tags: ["marketing-collateral"]
---

# Get Collateral Analysis History

`GET /marketing/collateral/{file_id}/analysis-history`

Marketing analysis history for a single collateral file.

## Path parameters

- `file_id` string, uuid, required

## Response `200`

Successful Response

- AnalysisHistoryResponse
  - `collateral` AnalysisHistoryDocument, required
    - `upload_id` string, uuid, required
    - `file_id` string, uuid, required
    - `filename` string, required
    - `created` string, date-time, required
    - `aws_key` string, nullable
    - `file_type` string, nullable
    - `transcript_from_video` boolean, nullable
    - `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'
    - `review_status` 'approved' | 'review_in_progress' | 'needs_remediation'
    - `preset_ids` string[], nullable
  - `latest_run_id` string, uuid, nullable, required
  - `risks` DocumentRiskResponse[], required
    - `risk_id` string, uuid, required
    - `document_id` string, uuid, required
    - `short_text` string, required
    - `explanation` string, required
    - `document_clause` string, nullable
    - `source_clause` string, required
    - `remediation` string, nullable
    - `severity` 'low' | 'medium' | 'high', required
    - `status` 'reject' | 'allow' | 'flag' | 'dismissed', required
    - `dismiss_reason` 'valid_ok' | 'already_met' | 'incorrect' | 'out_of_scope' | 'pre_approved' | 'other' — Why a reviewer dismissed a marketing risk (status=dismissed).
    - `dismiss_note` string, nullable
    - `made_obsolete_by` string, uuid, nullable, required
    - `ignore_comment` string, nullable, required
    - `notes` unknown
    - `citations` DocumentRiskCitation[], nullable
      - `cited_text` string, required
      - `start_page_number` integer, required
      - `end_page_number` integer, required
      - `bounding_boxes` BoundingBox[]
        - `x0` number, required
        - `y0` number, required
        - `x1` number, required
        - `y1` number, required
    - `created_by_user_id` string, uuid, nullable
    - `run_id` string, uuid, required
    - `suppressed_by_rule_id` string, uuid, nullable
    - `filename` string, nullable
    - `resolved` string, date-time, nullable
    - `issue_id` string, uuid, nullable
    - `assignee_id` string, uuid, nullable
    - `assignee_first_name` string, nullable
    - `assignee_last_name` string, nullable
    - `due_date` string, date, 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/f85ef083df64/schema)