> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List cards

> List cards in one Trello list with filters and cursors.

`listCards` returns a single Trello result page from one list.

```ts automations/list-trello-cards.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { listCards } from "automate.ax/trello"

export default automation("List open Trello cards", () => {
  onHttpRequest({ scope: "automation" })
  listCards({ listId: "list-id", filter: "open", limit: 100 })
})
```

\| Property  | Type                     | Required | Default         | Description                                    |
\| --------- | ------------------------ | -------- | --------------- | ---------------------------------------------- | -------- | -------------------------------------- |
\| `listId`  | `string`                 | Yes      | —               | Stable list ID.                                |
\| `filter`  | `"open"                  | "closed" | "all"`          | No                                             | `"open"` | Select active, archived, or all cards. |
\| `limit`   | `number`                 | No       | `100`           | Integer from 1 to 1,000.                       |
\| `before`  | `string`                 | No       | —               | Return cards before this card ID or timestamp. |
\| `since`   | `string`                 | No       | —               | Return cards since this card ID or timestamp.  |
\| `account` | Trello account reference | No       | Project default | Account used to read cards.                    |

Returns `Signal<TrelloCard[]>`. Trello applies `before` and `since`; the action does not fetch additional pages automatically.