---
title: "List Runs"
method: GET
path: "/internal/evals/requirement-applicability/runs"
tags: ["internal"]
---

# List Runs

`GET /internal/evals/requirement-applicability/runs`

## Query parameters

- `company_id` string, uuid, nullable
- `limit` integer

## Response `200`

Successful Response

- ApplicabilityRunSummary[]
  - `applicability_run_id` string, uuid, required
  - `company_id` string, uuid, required
  - `company_name` string, nullable, required
  - `file_id` string, uuid, required
  - `upload_id` string, uuid, required
  - `collateral_filename` string, nullable, required
  - `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', required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed', required — Lifecycle of one dashboard run. Mirrors `DecompositionStatus` deliberately.
  - `stage` 'queued' | 'downloading' | 'narrowing' | 'evaluating' | 'comparing' | 'done', required — What the run is doing right now. Committed *before* the work it names starts, so a watcher sees the stage currently taking the time rather than the last one that finished.
  - `error` string, nullable, required
  - `created` string, date-time, required
  - `started_at` string, date-time, nullable, required
  - `finished_at` string, date-time, nullable, required
  - `requested_by_email` string, nullable, required
  - `candidates_total` integer, required
  - `candidates_surviving` integer, required
  - `risks_produced` integer, 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/425d5b8a3c17/schema)