---
title: "List Runs"
method: GET
path: "/companies/{company_id}/runs"
tags: ["runs"]
---

# List Runs

`GET /companies/{company_id}/runs`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/runs`
- Auth: HTTP bearer

List runs for a company.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- RunListResponse
  - `runs` RunResponse[], required
    - `id` string, required
    - `company_id` string, required
    - `agent_id` string, nullable
    - `task_id` string, nullable
    - `run_type` 'ceo' | 'worker' | 'reporter' | 'worker_nextjs' | 'build_session' | 'session_turn'
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'interrupted' | 'waiting', required
    - `trigger` 'manual' | 'ceo_agent' | 'cron' | 'founding' | 'birth' | 'ask_answer' | 'routine' | 'platform' | 'founding_setup' | 'founding_build' | 'support' | 'outcome_start' | 'outcome_check' | 'outcome_continue' | 'outcome_message' | 'outcome_compact', required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `token_count_input` integer
    - `token_count_output` integer
    - `cost_usd` number
    - `error_message` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `85afb5563d7a`: 5 warning
  - added the new `outcome_check` enum value to the `runs/items/trigger` response property for the response status `200`
  - added the new `outcome_compact` enum value to the `runs/items/trigger` response property for the response status `200`
  - added the new `outcome_continue` enum value to the `runs/items/trigger` response property for the response status `200`
  - added the new `outcome_message` enum value to the `runs/items/trigger` response property for the response status `200`
  - …1 more
- **2026-10-07** `33b623259808`: 1 warning
  - added the new `support` enum value to the `runs/items/trigger` response property for the response status `200`
- **2026-09-23** `c4109d3755e1`: 2 warning
  - added the new `founding_build` enum value to the `runs/items/trigger` response property for the response status `200`
  - added the new `founding_setup` enum value to the `runs/items/trigger` response property for the response status `200`
- **2026-09-11** `97b262b63810`: 1 warning
  - added the new `routine` enum value to the `runs/items/trigger` response property for the response status `200`
- **2026-09-10** `22ea25f84a15`: 1 warning
  - added the new `platform` enum value to the `runs/items/trigger` response property for the response status `200`

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/runs/get.md)

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/291bb76b720b?raw)