---
title: "GET /v1/printers/{id}/status"
method: GET
path: "/v1/printers/{id}/status"
---

# GET /v1/printers/{id}/status

`GET /v1/printers/{id}/status`

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `status` string, nullable
  - `offline` boolean
  - `maintenance_mode` boolean
  - `ready` boolean
  - `ready_source` 'bed_occupancy_verified' | 'operator_override' | 'lock_recovery' | 'null', nullable
  - `ready_updated_source` 'bed_occupancy_verification' | 'operator_override' | 'lock_recovery' | 'fresh_job_claim' | 'retry_job_claim' | 'job_lock' | 'auto_bed_clear' | 'maintenance' | 'printer_disabled' | 'post_completion' | 'admin_bed_occupancy_test' | 'printer_created' | 'legacy_compatibility' | 'legacy_backfill'
  - `locked_by_job_id` number, nullable

## Other responses

- `400` — Default Response
- `500` — Default Response

## Changes

> 24 revisions in range; 2 could not be searched.

- **2026-08-25** `9fd4782d4ef4` — 1 info
  - added the optional property `offline` to the response with the `200` status
- **2026-08-20** `6fe5e0368cb0` — 1 breaking, 1 info
  - the response property `status` became nullable for the status `200`
  - added the optional property `maintenance_mode` to the response with the `200` status
- **2026-08-12** `844a2377a76d` — 1 info
  - added the optional property `ready_updated_source` to the response with the `200` status
- **2026-08-06** `8be36ce70a6b` — 2 warning
  - added the new `bed_occupancy_verified` enum value to the `ready_source` response property for the response status `200`
  - added the new `lock_recovery` enum value to the `ready_source` response property for the response status `200`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/printers/:id/status/get.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/daa5509d053e/schema)