---
title: "List the runs your team started"
method: GET
path: "/v1/runs"
tags: ["runs"]
---

# List the runs your team started

`GET /v1/runs`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/runs`
- Auth: HTTP bearer

Lists the runs your team started, newest first, one numbered page at a time, with the totals of every page. A run is listed when a team member started it, in the Dashboard, through an agent or with an API key, on any tool: the team's own or a public one.

- Every member sees every run the team started, whoever started it.
- Filter by integration, status, source and time range, or find one run by its ID.
- Runs stay listed for 90 days.
- To follow a run you just started, use jobs.get with its job ID. Use this list to look back over the team's runs.

## Query parameters

- `integration_id` string
- `status` 'queued' | 'running' | 'needs_input' | 'succeeded' | 'failed' | 'cancelled'
- `source` 'mcp' | 'api' | 'dashboard' | 'editor'
- `from` string
- `to` string
- `run_id` string
- `page` string
- `limit` string

## Response `200`

One page of the team's runs

- RunList
  - `data` Run[], required
    - `id` string, required
    - `status` 'queued' | 'running' | 'needs_input' | 'succeeded' | 'failed' | 'cancelled', required
    - `tool_id` string, required
    - `tool_name` string, nullable, required
    - `integration_id` string, nullable, required
    - `integration_name` string, nullable, required
    - `effect` 'read' | 'write', nullable, required
    - `write_status` 'not_attempted' | 'may_have_applied' | 'applied' | 'not_applied', nullable, required
    - `source` 'mcp' | 'api' | 'dashboard' | 'editor', nullable, required
    - `started_by` object, required
      - `member_id` string, required: The member's user ID
      - `name` string, nullable, required
      - `email` string, nullable, required
      - `api_key` object, nullable, required
        - `id` string, required
        - `name` string, required
    - `login_id` string, nullable, required
    - `revision` object, required
      - `id` string, required
      - `published_at` string, nullable, required
      - `draft_of_version` integer, nullable, required: a non-negative number
    - `attempts` integer, required: a non-negative number
    - `created_at` string, required
    - `started_at` string, nullable, required
    - `completed_at` string, nullable, required
    - `duration_ms` integer, nullable, required: a non-negative number
  - `page` integer, required: a non-negative number
  - `limit` integer, required: a non-negative number
  - `total` integer, required: Runs matching the filters, on every page
  - `summary` object, required
    - `succeeded` integer, required: a non-negative number
    - `failed` integer, required: a non-negative number
    - `cancelled` integer, required: a non-negative number
    - `in_progress` integer, required: Queued, running or waiting for an answer
    - `median_duration_ms` integer, nullable, required: a non-negative number

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: business_account_required, forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)