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

# See Who Is Riding the Roller Coaster

> See a live list of everyone who has taken a ride through this automation.

Curious how many people have journeyed through your automation?

This endpoint gives you a list of all the individual trips (runs), showing who entered, whether they are still riding, and when they hopped off!

### Path Parameters

<ParamField path="id" type="string" required>
  The ID badge of the automation whose riders you want to check.
</ParamField>

### Response

<ResponseField name="object" type="string">
  Always says `"list"`.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  `true` if there are even more riders to load on subsequent pages.
</ResponseField>

<ResponseField name="data" type="object[]">
  A list of all individual rider journeys:

  * `id`: The unique ticket ID for this ride (e.g. `"run_12345"`).
  * `status`: Where they are at (`"active"`, `"completed"`, `"waiting"`, or `"failed"`).
  * `started_at`: When they stepped onto the track.
  * `completed_at`: When they successfully crossed the finish line.
  * `created_at`: Time this run record was created.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.mailofly.com/automations/auto_9b83b384-3c66-4f81-a201-3829028198f1/runs' \
    -H 'Authorization: Bearer mf_live_xxxxxxxx'
  ```

  ```javascript Node.js theme={null}
  import { Mailofly } from "@mailofly/node";

  const mailofly = new Mailofly("mf_live_xxxxxxxx");

  const runs = await mailofly.automations.listRuns("auto_9b83b384-3c66-4f81-a201-3829028198f1");

  console.log(`Found ${runs.data.length} riders!`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "object": "list",
    "has_more": false,
    "data": [
      {
        "id": "run_04a80291-5f21-4f11-9a01-1829018274a1",
        "status": "completed",
        "started_at": "2026-04-12T10:00:00.000Z",
        "completed_at": "2026-04-12T10:00:05.000Z",
        "created_at": "2026-04-12T10:00:00.000Z"
      },
      {
        "id": "run_88b19283-11a2-4821-bc10-091827361823",
        "status": "active",
        "started_at": "2026-04-12T11:30:00.000Z",
        "completed_at": null,
        "created_at": "2026-04-12T11:30:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.