---
title: "Get Paged Agent Runs"
method: GET
path: "/internal/agent-runs/paged"
tags: ["internal"]
---

# Get Paged Agent Runs

`GET /internal/agent-runs/paged`

Paginated agent runs for the admin agent runs dashboard.

The window is the absolute half-open interval `[from_time, to_time)`. The
dashboard sends the UTC instants for the edges of the operator's *local*
calendar days, so filtering to one past day means that day in their
timezone -- the boundaries cannot be inferred from a bare date here.
A naive value is read as UTC.

An omitted or empty `agent_types` / `status` / `company_ids` means every
value on that axis.

The `/runs` endpoints below still take `from_date`/`to_date` date strings,
and so still carry the UTC-offset skew this signature removes; they back a
different dashboard and were left on the old contract deliberately.

## Query parameters

- `from_time` string, date-time, required
- `to_time` string, date-time, required
- `page` integer
- `page_size` integer
- `agent_types` AgentType[], nullable
- `status` AgentRunStatus[], nullable
- `company_ids` string[], nullable

## Response `200`

Successful Response

- GetPagedAgentRunsResponse
  - `agent_runs` AgentRunListItem[], required
    - `agent_run_id` string, uuid, required
    - `status` 'pending' | 'running' | 'completed' | 'failed', 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', required
    - `created` string, date-time, required
    - `company_id` string, uuid, required
  - `total_count` integer, required
  - `companies_with_agent_runs` string[], required

## 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/3ff4c0bd276b/schema)