---
title: "List a schedule's runs"
method: GET
path: "/v1/schedules/{scheduleId}/runs"
tags: ["Schedules"]
---

# List a schedule's runs

`GET /v1/schedules/{scheduleId}/runs`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/schedules/{scheduleId}/runs`
- Auth: HTTP bearer

Returns the schedule's most recent runs, newest first, with their status and the draft post each run created.

## Path parameters

- `scheduleId` string, required

## Query parameters

- `limit` integer

## Response `200`

Schedule runs fetched successfully

- object
  - `runs` object[], required
    - `id` string, required
    - `status` 'running' | 'success' | 'failed' | 'skipped', required: `running` until the run reports back. A run that never reports back is shown as `failed` after six hours.
    - `title` string, nullable, required: Title of what the run produced, null while running.
    - `postId` string, nullable, required: The draft post the run created, if any.
    - `errorMessage` string, nullable, required
    - `manual` boolean, required: Started on demand rather than by the schedule.
    - `startedAt` string, required
    - `finishedAt` string, nullable, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

- `400`: Invalid query params
- `401`: Missing or invalid API key
- `403`: Forbidden
- `404`: Schedule not found
- `500`: Failed to list schedule runs
- `503`: Authentication service unavailable

## Changes

- **2026-10-28** `5d236d77f14c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/schedules/:scheduleId/runs/get.md)

---

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