---
title: "List automations"
method: GET
path: "/api/v1/automations"
tags: ["Automations"]
---

# List automations

`GET /api/v1/automations`

## Request

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

List the user's automations — standing orders Roma runs on its own, on a schedule or on demand. Returns each one's id, name, what it does, status (active / paused / draft), when it runs, the next run, and how the last run ended. Use it when the user asks what runs on its own, when something runs next, or before reading or starting a run.

## Response `200`

The tool's result.

- object
  - `count` number, required
  - `automations` object[], required
    - `id` string, required
    - `name` string, required
    - `status` string, required
    - `when` string, required
    - `nextRunAt` 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)