---
title: "List runs across the org"
method: GET
path: "/v1/developer/runs/"
tags: ["Runs"]
---

# List runs across the org

`GET /v1/developer/runs/`

## Request

- Base URL: `https://screensdesign.com`
- URL: `https://screensdesign.com/v1/developer/runs/`
- Auth: HTTP bearer

List generation runs across all projects in your organization. Useful for finding lost runs or seeing what's currently being generated. Default filter is `active` (running, waiting). Capped at 100 results.

## Query parameters

- `status` 'active' | 'all' | 'completed' | 'failed'

## Response `200`

List of runs matching the status filter (capped at 100).

- object

## Other responses

- `400`: Invalid request body or query parameters.
- `401`: Missing or invalid API key.
- `403`: Your API key is missing the required scope for this endpoint.
- `429`: Rate limit exceeded. Wait and retry.

---

[API](https://skmtc.dev/screensdesign/apis/screensdesign-create-developer-api.md) · [All operations](https://skmtc.dev/screensdesign/apis/screensdesign-create-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/screensdesign/apis/screensdesign-create-developer-api/revisions/8c2fab15e11c?raw)