---
title: "Get Scheduled Task Run"
method: GET
path: "/scheduled_tasks/{scheduled_task_id}/runs/{run_id}"
---

# Get Scheduled Task Run

`GET /scheduled_tasks/{scheduled_task_id}/runs/{run_id}`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/scheduled_tasks/{scheduled_task_id}/runs/{run_id}`
- Auth: none declared

Get a single run with its prompt, result, failure, and meta.

## Path parameters

- `scheduled_task_id` integer, required
- `run_id` integer, required

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- ScheduledTaskRunDetailSchema
  - `id` integer, required
  - `scheduled_task_id` integer, required
  - `status` 'running' | 'success' | 'failed' | 'cancelled', required
  - `is_manual` boolean, required
  - `duration_ms` integer, nullable, required
  - `started_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required
  - `agent_session_id` integer, nullable, required
  - `skip_delivery_reason` string, nullable, required
  - `delivery` RunDelivery, required
    - `slack` 'delivered' | 'failed'
    - `email` 'delivered' | 'failed'
  - `prompt` string, required
  - `result` ReportOutput, required
    - `status` 'ok' | 'no_data'
    - `slack` SlackPayload
      - `text` string, required
    - `email` EmailPayload
      - `subject` string, required
      - `body_html` string, required
    - `reason` string, nullable
  - `failure` FailurePayload, required
    - `type` string, required
    - `message` string, required
  - `meta` ScheduledTaskRunMeta, required: Per-run sidecar data: LLM stats, delivery results, cancel reason.
    - `model` string, nullable
    - `message_id` string, nullable
    - `stop_reason` string, nullable
    - `input_tokens` integer, nullable
    - `output_tokens` integer, nullable
    - `cache_read_input_tokens` integer, nullable
    - `cache_creation_input_tokens` integer, nullable
    - `tool_calls` integer, nullable
    - `mcp_tool_calls` integer, nullable
    - `block_counts` object, nullable
    - `response_chars` integer, nullable
    - `cancel_reason` string, nullable
    - `deliveries` DeliveryRecords
      - `slack` SlackDeliveryRecord
        - `channel` string, nullable
        - `channel_id` string, nullable
        - `ok` boolean, required
        - `error` string, nullable
        - `ts` string, nullable
      - `email` EmailDeliveryRecord[], nullable
        - `email` string, required
        - `ok` boolean, required
        - `error` string, nullable
    - `attempts` integer, nullable
    - `message_duration_ms` integer, nullable
    - `num_turns` integer, nullable
    - `total_cost_usd` number, nullable
  - `blocks` object[], nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-22** `d6d3aaeaef74`: 1 warning
  - removed the optional property `meta/plan_generated` from the response with the `200` status

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/scheduled_tasks/:scheduled_task_id/runs/:run_id/get.md)

---

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