---
title: "Recent runs of an automation"
method: GET
path: "/api/v1/automations/{id}/runs"
tags: ["Automations"]
---

# Recent runs of an automation

`GET /api/v1/automations/{id}/runs`

## Request

- Base URL: `https://api.roma.app`
- URL: `https://api.roma.app/api/v1/automations/{id}/runs`
- Auth: HTTP bearer

Read one automation's recent runs, newest first: when each ran, how it ended, what it wrote (one line per action), the message it left for the user, and any error. Use it for "what did my morning brief find", "why did it fail", or to read the result of a run started with run_automation once it has finished.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer: How many runs, newest first (default 5, max 20).

## Response `200`

The tool's result.

- object
  - `automation` object, required
    - `id` string, required
    - `name` string, required
  - `runs` object[], required
    - `id` string, required
    - `status` string, required
    - `startedAt` string, required
    - `finishedAt` string, nullable, required

## Other responses

- `400`: The request was understood and refused; the error says what to change.
- `401`: No usable bearer token.
- `404`: No such item for this account.
- `405`: The path exists but not with this method; Allow lists the ones that work.
- `429`: Over the rate limit; wait for Retry-After.

---

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