---
title: "Get Agent Run Status"
method: GET
path: "/agent-runs/{agent_run_id}/status"
tags: ["agent-runs"]
---

# Get Agent Run Status

`GET /agent-runs/{agent_run_id}/status`

Generic status check for any AgentRun subclass.

Queries the base agent_runs table so it works for SmartDocumentAgentRun,
ReviewReportingAgentRun, FormFieldDeriverAgentRun, and any future types
without per-type plumbing.

## Path parameters

- `agent_run_id` string, uuid, required

## Response `200`

Successful Response

- union
  - AgentRunStatusResponse
    - `agent_run_id` string, uuid, required
    - `agent_type` 'form_field_deriver' | 'service_ira' | 'vendor_ira' | 'review_report' | 'smart_document' | 'documents_consolidated_view' | 'regulatory_review' | 'contract_summary' | 'review_metadata' | 'risk_assessment_research' | 'risk_assessment_factor' | 'risk_factor_training' | 'control_assessment' | 'marketing_guideline_decomposition' | 'marketing_guideline_enrichment', required
    - `status` 'pending' | 'running' | 'completed' | 'failed', required
  - ReportingAgentRunResult
    - `agent_run_id` string, uuid, required
    - `agent_type` 'form_field_deriver' | 'service_ira' | 'vendor_ira' | 'review_report' | 'smart_document' | 'documents_consolidated_view' | 'regulatory_review' | 'contract_summary' | 'review_metadata' | 'risk_assessment_research' | 'risk_assessment_factor' | 'risk_factor_training' | 'control_assessment' | 'marketing_guideline_decomposition' | 'marketing_guideline_enrichment', required
    - `status` 'pending' | 'running' | 'completed' | 'failed', required
    - `result_upload_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-02** `425d5b8a3c17` — 4 warning
  - added the new `marketing_guideline_decomposition` enum value to the `anyOf[subschema #1: AgentRunStatusResponse]/agent_type` response property for the response status `200`
  - added the new `marketing_guideline_decomposition` enum value to the `anyOf[subschema #2: ReportingAgentRunResult]/agent_type` response property for the response status `200`
  - added the new `marketing_guideline_enrichment` enum value to the `anyOf[subschema #1: AgentRunStatusResponse]/agent_type` response property for the response status `200`
  - added the new `marketing_guideline_enrichment` enum value to the `anyOf[subschema #2: ReportingAgentRunResult]/agent_type` response property for the response status `200`

[Change history](https://skmtc.dev/kobaltlabs/apis/fastapi/changes/agent-runs/:agent_run_id/status/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/425d5b8a3c17/schema)