---
title: "List Run History"
method: GET
path: "/api/runs"
tags: ["runs"]
---

# List Run History

`GET /api/runs`

## Request

- Base URL: `https://api.retirementlab.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retirementlab.app/api/runs`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `before` string
- `config_id` integer
- `source` string
- `status` 'queued' | 'running' | 'succeeded' | 'failed'

## Response `200`

Successful Response

- RunListResponse
  - `items` RunListItem[], required
    - `run_id` integer, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
    - `run_kind` string, required
    - `sweep_variable` string
    - `point_count` integer
    - `requested_at` string, date-time, required
    - `finished_at` string, date-time
    - `failure_probability` number
    - `run_source` string
    - `config_id` integer
    - `config_name` string
    - `ephemeral` boolean
    - `label` string, required
    - `assumptions_version` string
    - `assumptions_version_state` 'declared' | 'legacy_unverified'
  - `next_before` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/retirementlab/apis/income-simulator-api.md) · [All operations](https://skmtc.dev/retirementlab/apis/income-simulator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retirementlab/apis/income-simulator-api/revisions/b0f00a0333fd?raw)