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

# List Runs

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

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/internal/evals/requirement-applicability/runs`
- Auth: none declared

## 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/kobaltlabs-api.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/revisions/8587332d5e43?raw)