---
title: "Runs of a DM automation"
method: GET
path: "/v1/dm-automations/{id}/runs"
---

# Runs of a DM automation

`GET /v1/dm-automations/{id}/runs`

## Request

- Base URL: `https://api.breakreach.com`
- URL: `https://api.breakreach.com/v1/dm-automations/{id}/runs`
- Auth: HTTP bearer

Each person who went through it, newest first, kept 90 days: every step sent, choices tapped, clicks, and how it ended. Webhooks subscribed to dm_automation.started, dm_automation.handoff, dm_automation.finished and dm_automation.failed get the same events as they happen.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `workspace` string

## Response `200`

OK

- object
  - `runs` DmAutomationRun[]
    - `id` string
    - `automationId` string
    - `status` 'running' | 'waiting' | 'completed' | 'handed_off' | 'stopped' | 'window_closed' | 'failed'
    - `contact` object
      - `id` string: Instagram-scoped or Page-scoped id
      - `username` string, nullable
      - `name` string, nullable
    - `trigger` object
      - `type` string
      - `text` string, nullable
      - `ref` string, nullable
    - `stepId` string, nullable
    - `waiting` object, nullable
      - `kind` 'timer' | 'choice' | 'reply' | 'click'
      - `stepId` string
      - `until` string, date-time
    - `clicks` integer
    - `log` object[]
      - `at` string, date-time
      - `kind` string: trigger, sent, choice, reply, click, branch, wait, waited, handoff, end, error
      - `stepId` string, nullable
      - `text` string, nullable
      - `detail` string, nullable
    - `endReason` string, nullable: done, handoff, human_replied (someone answered by hand), window (Meta's 24-hour window closed), paused, deleted, flow_changed, stopped_by_team, send, account
    - `error` string, nullable
    - `createdAt` string, date-time
    - `endedAt` string, date-time, nullable

## Other responses

- `401`: Missing, invalid or expired API key
- `402`: No active Breakreach subscription or trial
- `403`: Not a member of the requested workspace
- `404`: Automation or workspace not found

---

[API](https://skmtc.dev/breakreach/apis/breakreach-api.md) · [All operations](https://skmtc.dev/breakreach/apis/breakreach-api/llms.txt) · [OpenAPI document](https://skmtc.dev/breakreach/apis/breakreach-api/revisions/290d285f8d73?raw)