---
title: "List run history for a job"
method: GET
path: "/api/v1/economy/schedules/{name}/runs"
tags: ["economy-admin"]
---

# List run history for a job

`GET /api/v1/economy/schedules/{name}/runs`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/economy/schedules/{name}/runs`
- Auth: HTTP bearer

List run history for a job

## Path parameters

- `name` 'daily-loans' | 'community-payments' | 'land-draw' | 'monthly-tokens' | 'weekly-inactivity-report', required

## Query parameters

- `limit` number
- `offset` number

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `runs` object[], required
      - `id` string
      - `name` string
      - `periodKey` string
      - `scheduledAt` string, date-time
      - `createdAt` string, date-time
      - `completedAt` string, date-time, nullable
      - `status` string
      - `trigger` string
      - `triggeredBy` string, nullable
      - `running` boolean
      - `completed` integer
      - `failed` integer
      - `pending` integer
  - `meta` object, required
    - `timestamp` number, required
    - `pagination` object, required
      - `total` number, required
      - `limit` number, required
      - `offset` number, required
      - `hasMore` boolean, required
  - `_links` object: HATEOAS pagination links
    - `self` object
      - `href` string, required
      - `rel` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
      - `type` string
    - `first` object
      - `href` string, required
      - `rel` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
      - `type` string
    - `prev` object
      - `href` string, required
      - `rel` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
      - `type` string
    - `next` object
      - `href` string, required
      - `rel` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
      - `type` string
    - `last` object
      - `href` string, required
      - `rel` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
      - `type` string

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `500`: Default Response

## Changes

- **2026-09-16** `5a21657c59d7`: 1 info
  - added the new enum value `weekly-inactivity-report` to the `path` request parameter `name`
- **2026-09-12** `5e1c5e927b1e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/changes/api/v1/economy/schedules/:name/runs/get.md)

---

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