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

# Get cooling state

`GET /api/v1/cooling/state`

## Request

- Base URL: `http://miner`
- URL: `http://miner/api/v1/cooling/state`
- Auth: none declared
- TypeScript: <https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api/docs/api/v1/cooling/state/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/256foundation/apis/braiins-os-public-rest-api.md) - [All operations](https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api/revisions/d341c8e1d506?raw)