---
title: "List automations"
description: "Every automation in the workspace, most recently changed first, without the definition or settings."
url: "https://openemail.uk/docs/api/automations/list"
area: "API"
category: "Mailbox"
---

# List automations

Every automation in the workspace, most recently changed first, without the definition or settings.

`GET /automations`

## GET /automations

Every automation in the workspace, most recently changed first, without the definition or settings.

## Example

Needs `automations:read`. `status` narrows the list to `draft`, `live`, `paused` or `archived`. `limit` goes up to 100 and defaults to 50, and `cursor` takes the previous page’s `nextCursor`.

**curl**

```
curl "$OE/automations?status=live" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "automation",
      "id": "aut_7c2e9a1f4b8d30c65e1a9f27",
      "name": "Welcome series",
      "description": null,
      "status": "live",
      "triggerKind": "audience_joined",
      "stepCount": 4,
      "emailCount": 2,
      "hasUnpublishedChanges": false,
      "publishedVersion": 2,
      "pausedReason": null,
      "lastError": null,
      "counts": { "active": 38, "completed": 412, "exited": 9 },
      "createdBy": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E",
      "publishedAt": "2026-10-02T09:14:00.000Z",
      "pausedAt": null,
      "archivedAt": null,
      "createdAt": "2026-10-01T16:40:12.000Z",
      "updatedAt": "2026-10-02T09:14:00.000Z"
    }],
  "hasMore": false,
  "nextCursor": null
}
```

> `counts` are the people inside now, the people who finished and the people who left early, across every version.

> An app a member connected lists only the automations that member made.

## Reference

- [`GET /automations`](https://openemail.uk/docs/api/reference/automations#get-automations): full reference