---
title: "Get scanner cadence status"
method: GET
path: "/api/image-updates/status"
tags: ["Image Updates"]
---

# Get scanner cadence status

`GET /api/image-updates/status`

Returns the scanner's current status including scheduling mode and next check time.

## Response `200`

Scanner status.

- ImageUpdateCheckStatus
  - `checking` boolean — `true` if a scan is currently running.
  - `intervalMinutes` integer — Configured fallback interval in minutes (15-1440).
  - `lastCheckedAt` integer, nullable — Unix epoch-ms of the last check start, or null if never checked.
  - `nextCheckAt` integer, nullable — Unix epoch-ms of the next scheduled check, or null when not scheduled.
  - `manualCooldownMinutes` integer — Fixed cooldown ceiling in minutes for manual refresh.
  - `manualCooldownRemainingMs` integer — Live remaining cooldown in milliseconds (0 when refresh is allowed).
  - `mode` 'interval' | 'cron' — Active scheduling mode.
  - `cronExpression` string, nullable — 5-field cron expression when mode is 'cron', null otherwise.
  - `sidebarIndicators` boolean — Whether sidebar update-status indicators are enabled. Controlled by the `image_update_sidebar_indicators` global setting. Default is `false`.

## Other responses

- `401` — Authentication required. Provide a valid Bearer token.

## Changes

- **2026-07-05** `e3dfbceb37b7` — 1 info
  - added the optional property `sidebarIndicators` to the response with the `200` status
- **2026-06-25** `9a8f53dbac8f` — 1 breaking, 7 info
  - the response property `checking` became optional for the status `200`
  - added the optional property `cronExpression` to the response with the `200` status
  - added the optional property `intervalMinutes` to the response with the `200` status
  - added the optional property `lastCheckedAt` to the response with the `200` status
  - …4 more
- **2026-06-04** `d58cf9d6195b` — 1 info
  - removed the `ADMIRAL_REQUIRED` enum value from the `code` response property for the response status `401`
- **2026-04-05** `7464894ea582` — 1 warning, 1 info
  - added the new `PAID_REQUIRED` enum value to the `code` response property for the response status `401`
  - removed the `PRO_REQUIRED` enum value from the `code` response property for the response status `401`
- **2026-04-05** `a202861afa64` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/studio-saelix/apis/sencho-api/changes/api/image-updates/status/get.md)

---

[API](https://skmtc.dev/studio-saelix/apis/sencho-api.md) · [All operations](https://skmtc.dev/studio-saelix/apis/sencho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/studio-saelix/sencho-api/revisions/82aac94c016e/schema)