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

# List Runs

`GET /runs`

## Request

- Base URL: `https://api.server.test/v1`
- URL: `https://api.server.test/v1/runs`
- Auth: none declared
- TypeScript: <https://skmtc.dev/natlabrockies/apis/alfalfa-boptest-unified-virtual-building-control-api-abuvbca/docs/runs/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- object
  - `payload` RunMetadata[]
    - `id` string
    - `name` string
    - `status` 'CREATED' | 'PREPROCESSING' | 'READY' | 'STARTING' | 'STARTED' | 'RUNNING' | 'STOPPING' | 'COMPLETE' | 'ERROR'
    - `datetime` string, date-time
    - `simType` 'OPENSTUDIO' | 'MODELICA' | 'OTHER'
    - `uploadTimestamp` string, date-time
    - `errorLog` string

---

[API](https://skmtc.dev/natlabrockies/apis/alfalfa-boptest-unified-virtual-building-control-api-abuvbca.md) - [All operations](https://skmtc.dev/natlabrockies/apis/alfalfa-boptest-unified-virtual-building-control-api-abuvbca/llms.txt) - [OpenAPI document](https://skmtc.dev/natlabrockies/apis/alfalfa-boptest-unified-virtual-building-control-api-abuvbca/revisions/82daf0dd2712?raw)