---
title: "Get Trigger Execution History"
method: POST
path: "/v1/clusters/triggers/{trigger_id}/history"
tags: ["Cluster Triggers"]
---

# Get Trigger Execution History

`POST /v1/clusters/triggers/{trigger_id}/history`

Get execution history for a trigger with pagination.

## Path parameters

- `trigger_id` string, required — Trigger ID

## Request body

- TriggerHistoryRequest — Request for trigger execution history.
  - `offset` integer — Pagination offset
  - `limit` integer — Results per page
  - `status_filter` string, nullable — Filter by execution status

## Response `200`

Successful Response

- SharedClustersTriggersModelsTriggerHistoryResponse — Response for trigger execution history.
  - `trigger_id` string, required — Trigger ID
  - `executions` TriggerExecutionHistoryItem[], required — Execution history
    - `job_id` string, required — Job ID
    - `triggered_at` string, date-time, required — When trigger fired
    - `status` string, required — Execution status
    - `execution_time_ms` integer, nullable — Execution time in milliseconds
    - `error` string, nullable — Error message if failed
    - `num_clusters` integer, nullable — Number of clusters created
    - `num_documents` integer, nullable — Number of documents processed
  - `total` integer, required — Total executions
  - `offset` integer, required — Current offset
  - `limit` integer, required — Current limit

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/5d4c905106b4/schema)