---
title: "List task execution history"
method: GET
path: "/api/scheduled-tasks/{id}/runs"
tags: ["Scheduled Tasks"]
---

# List task execution history

`GET /api/scheduled-tasks/{id}/runs`

Returns paginated execution history for a scheduled task. Requires admin role.

## Path parameters

- `id` integer, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Array of task run records.

- ScheduledTaskRun[]
  - `id` integer, required
  - `task_id` integer, required
  - `started_at` integer, required — Unix timestamp (seconds).
  - `completed_at` integer, nullable
  - `triggered_by` 'scheduled' | 'manual', required
  - `status` 'pending' | 'running' | 'success' | 'failed', required
  - `output` string, nullable
  - `error` string, nullable

## Other responses

- `400` — Invalid task ID.
- `403` — Insufficient permissions or license tier.
- `404` — Resource not found.
- `500` — Internal server error.

---

[API](https://skmtc.net/studio-saelix/apis/sencho-api.md) · [All operations](https://skmtc.net/studio-saelix/apis/sencho-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/studio-saelix/sencho-api/versions/f36f82acae1d/schema)