---
title: "Get Report Generation Status"
method: GET
path: "/v1/interviews/{interview_id}/report/generation-status"
tags: ["campaign-reports"]
---

# Get Report Generation Status

`GET /v1/interviews/{interview_id}/report/generation-status`

Return the status of the newest report version (any status), or an
empty payload if no version exists yet.

## Path parameters

- `interview_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- ReportGenerationStatusOut — Latest version regardless of readiness — lets the report page tell generating / failed / ready apart without downloading artifacts. Deliberately no error_message: version errors are raw worker tracebacks, which never belong in a user-facing surface.
  - `status` 'in_progress' | 'ready' | 'failed'
  - `version_number` integer, nullable
  - `trigger_reason` 'threshold_reached' | 'incremental_update' | 'manual_regenerate' — What caused a campaign report version to be generated.
  - `created_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)