---
title: "Retrive the current printer state"
method: GET
path: "/api/printer"
---

# Retrive the current printer state

`GET /api/printer`

## Query parameters

- `exclude` string[]

## Response `200`

OK

- object
  - `temperature` TemperatureState
    - `tool0` TemperatureData
      - `actual` number — Current temperature
      - `target` number, nullable — Target temperature
      - `offset` number, nullable — Currenntly configured temperature offset to apply.
    - `bed` TemperatureData
      - `actual` number — Current temperature
      - `target` number, nullable — Target temperature
      - `offset` number, nullable — Currenntly configured temperature offset to apply.
    - `chamber` TemperatureData
      - `actual` number — Current temperature
      - `target` number, nullable — Target temperature
      - `offset` number, nullable — Currenntly configured temperature offset to apply.
  - `sd` SDState
    - `ready` boolean
  - `state` PrinterState
    - `text` 'Operational' | 'Printing' | 'Pausing' | 'Paused' | 'Cancelling' | 'Error' | 'Offline' | 'Busy'
    - `flags` object
      - `operational` boolean
      - `paused` boolean
      - `printing` boolean
      - `cancelling` boolean
      - `pausing` boolean
      - `sdReady` boolean
      - `error` boolean
      - `ready` boolean
      - `closedOrError` boolean
      - `busy` boolean
  - `telemetry` union
    - TelemetryMini
      - `temp_bed` number
      - `temp_nozzle` number
      - `material` string
    - TelemetrySL1
      - `fanUvLed` integer
      - `fanBlower` integer
      - `fanRear` integer
      - `coverClosed` boolean
      - `tempAmbient` number
      - `tempCpu` number
      - `tempUvLed` number

## Other responses

- `403` — Unauthorized

## Changes

- **2021-09-23** `7ad880a6c0c4` — 11 info
  - added the optional property `telemetry/oneOf[#/components/schemas/TelemetryMini]/temp_bed` to the response with the `200` status
  - added the optional property `telemetry/oneOf[#/components/schemas/TelemetryMini]/temp_nozzle` to the response with the `200` status
  - added the optional property `telemetry/oneOf[#/components/schemas/TelemetrySL1]/tempAmbient` to the response with the `200` status
  - added the optional property `telemetry/oneOf[#/components/schemas/TelemetrySL1]/tempCpu` to the response with the `200` status
  - …7 more
- **2021-04-15** `50f55b7fa1c5` — 6 warning, 1 info
  - removed the optional property `telemetry/oneOf[#/components/schemas/TelemetryMini]/temp_bed` from the response with the `200` status
  - removed the optional property `telemetry/oneOf[#/components/schemas/TelemetryMini]/temp_nozzle` from the response with the `200` status
  - removed the optional property `telemetry/oneOf[#/components/schemas/TelemetrySL1]/tempAmbient` from the response with the `200` status
  - removed the optional property `telemetry/oneOf[#/components/schemas/TelemetrySL1]/tempCpu` from the response with the `200` status
  - …3 more
- **2021-02-22** `30eda14983ed` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/prusa3d/apis/prusalink-web/changes/api/printer/get.md)

---

[API](https://skmtc.dev/prusa3d/apis/prusalink-web.md) · [All operations](https://skmtc.dev/prusa3d/apis/prusalink-web/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prusa3d/prusalink-web/revisions/ebdce30f1db8/schema)
