---
title: "List runs"
method: GET
path: "/routines/{jobId}/runs"
tags: ["routines"]
---

# List runs

`GET /routines/{jobId}/runs`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/routines/{jobId}/runs`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List runs for a routine.

## Path parameters

- `jobId` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful response

- object
  - `entries` object[], required
    - `ts` number, required
    - `jobId` string, required
    - `action` string, required
    - `status` 'ok' | 'error' | 'skipped' | 'running'
    - `error` string
    - `summary` string
    - `sessionId` string
    - `runAtMs` number
    - `durationMs` number
    - `nextRunAtMs` number

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)