---
title: "List run summaries"
method: GET
path: "/api/v1/runs"
tags: ["runs"]
---

# List run summaries

`GET /api/v1/runs`

## Request

- Base URL: `https://api.agenticcontrolplane.com`
- URL: `https://api.agenticcontrolplane.com/api/v1/runs`
- Auth: HTTP bearer

## Query parameters

- `agent` string
- `window` 'today' | '24h' | '7d' | '30d' | '90d'
- `limit` integer

## Response `200`

Runs, newest first.

- object
  - `ok` boolean
  - `count` integer
  - `window` string
  - `runs` object[]

## Other responses

- `401`: Missing, malformed, invalid, or revoked gsk_ API key.
- `500`: Server error.

---

[API](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api.md) · [All operations](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/revisions/161819f3df00?raw)