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

# List runs

`GET /runs`

## Request

- Base URL: `https://app.uselamina.ai/v1`
- URL: `https://app.uselamina.ai/v1/runs`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

List past runs for the workspace with optional filters.

## Query parameters

- `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
- `appId` string, uuid
- `limit` integer
- `offset` integer
- `since` string, date-time

## Response `200`

Paginated run list

- object
  - `data` ExecutionSummary[], required
    - `runId` string, uuid, required
    - `workflowId` string, uuid, required
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled', required
    - `source` string
    - `errorMessage` string, nullable
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
  - `pagination` Pagination, required
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/uselamina/apis/lamina-v1-api.md) · [All operations](https://skmtc.dev/uselamina/apis/lamina-v1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uselamina/apis/lamina-v1-api/revisions/73b598526531?raw)