---
title: "GMV Max automation run history"
method: GET
path: "/gmv-max/automations/{automation_id}/runs"
tags: ["GMV Max"]
---

# GMV Max automation run history

`GET /gmv-max/automations/{automation_id}/runs`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/automations/{automation_id}/runs`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Full run history for one automation (most recent first), including trigger source, start/finish timestamps, success/failure status, and per-run summary metrics. Single shop only.

## Path parameters

- `automation_id` integer, required

## Response `200`

Successful Response

- AutomationRunListResponse
  - `runs` AutomationRunSummary[], required
    - `id` integer, required
    - `automation_id` integer, required
    - `status` string, required
    - `actions_taken` unknown[], nullable
      - unknown
    - `metrics_snapshot` object, nullable
    - `error_message` string, nullable
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
  - `count` integer, required

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-04** `3530675d2c2a`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `count` to the response with the `200` status
  - added the required property `runs` to the response with the `200` status
- **2026-09-19** `291230805105`: 1 info
  - api operation id `automation_runs_gmv_max_automations__automation_id__runs_get` removed and replaced with `gmv_max_automation_runs`

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/automations/:automation_id/runs/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)