---
title: "List routine runs — every fire attempt [read]"
method: GET
path: "/routine-runs"
---

# List routine runs — every fire attempt \[read\]

`GET /routine-runs`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/routine-runs`
- Auth: HTTP bearer

## Query parameters

- `routine` string
- `has_error` boolean
- `trigger_type` 'schedule' | 'manual'
- `created_at[gte]` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- object
  - `items` RoutineRun[], required
    - `id` string: rrun_… identifier
    - `routine_id` string
    - `trigger_context` object: {type:"schedule", scheduled_at} | {type:"manual"}
    - `session_id` string, nullable
    - `error` object, nullable: {type, message}. Types: agent_archived_error · agent_not_found_error · session_archived_error · session_not_found_error · session_busy_error · environment_archived_error · environment_not_found_error · vault_not_found_error · insufficient_credits_error · rate_limited_error · run_rejected_error · unknown_error. Unrecoverable types auto-pause the routine; transient ones (credits, rate limit, busy) leave it active for the next occurrence. precheck_unchanged is not a failure: the scheduled fire was skipped because the routine's precheck URL returned the same content as at the last run; no session started, the routine stays active and no routine_run webhook is sent.
    - `agent` object: Resolved agent reference at fire time
    - `created_at` string
  - `cursor` string, nullable
  - `hasMore` boolean

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 4 info
  - added the optional property `error/request_id` to the response with the `default` status
  - the response property `error` became required for the status `default`
  - the response property `error/code` became required for the status `default`
  - the response property `error/message` became required for the status `default`

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/routine-runs/get.md)

---

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