---
title: "Get cooling state"
method: GET
path: "/api/v1/cooling/state"
tags: ["Cooling"]
---

# Get cooling state

`GET /api/v1/cooling/state`

Retrieves the current cooling state of the miner, including temperature measurements and the state of all fans.

## Response `200`

Successful response containing information about temperature measurements and fans states

- GetCoolingStateResponse — Response to get current fan states and temperature measurements
  - `fans` FanState[], required — All Fans state
    - `position` integer, nullable — Fan positions/ID
    - `rpm` integer, required — Actual fan RPM (Revolutions/Rotation Per Minute)
    - `target_speed_ratio` number, double, nullable — Actual fan speed ratio(PWM) in range 0.0 - 1.0
  - `highest_temperature` TemperatureSensor
    - `id` integer, nullable — Sensor id
    - `location` integer, required — Sensor location
    - `temperature` Temperature
      - `degree_c` number, double, required

---

[API](https://skmtc.net/256foundation/apis/braiins-os-public-rest-api.md) · [All operations](https://skmtc.net/256foundation/apis/braiins-os-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/256foundation/braiins-os-public-rest-api/revisions/d341c8e1d506/schema)