---
title: "Get a timer job by ID"
method: GET
path: "/api/timers/{id}"
tags: ["Timers"]
---

# Get a timer job by ID

`GET /api/timers/{id}`

## Path parameters

- `id` string, required

## Response `200`

Timer job found

- TimerJob
  - `id` string — Unique identifier for the timer job
  - `name` string, required — Human-readable name for the timer job
  - `enable` boolean — Whether this timer job is active
  - `type` string, required — Target subsystem type (equipment, macro, ato, camera, doser, lighting, ph, temperature, reminder)
  - `month` string, required — Cron month field
  - `week` string, required — Cron day-of-week field
  - `day` string, required — Cron day-of-month field
  - `hour` string, required — Cron hour field
  - `minute` string, required — Cron minute field
  - `second` string, required — Cron second field
  - `target` unknown

## Other responses

- `401` — Unauthorized
- `404` — Timer job not found

---

[API](https://skmtc.net/reef-pi/apis/reef-pi-api.md) · [All operations](https://skmtc.net/reef-pi/apis/reef-pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reef-pi/reef-pi-api/revisions/85b870dc1814/schema)