---
title: "Get tuner state"
method: GET
path: "/api/v1/performance/tuner-state"
tags: ["Performance"]
---

# Get tuner state

`GET /api/v1/performance/tuner-state`

## Request

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

Fetches miner's tuner state, including overall tuner state and power or hashrate mode both including profile and current target.

## Response `200`

Successful response containing tuner state.

- GetTunerStateResponse: Response with the current tuner details
  - `mode_state` union
    - object
      - `powertargetmodestate` PowerTargetModeState, required
        - `current_target` Power
          - `watt` integer, required
        - `profile` PowerTargetProfile: Structure to handle power target profile
          - `created` Timestamp: Custom version of google.protobuf.Timestamp It is used only during compilation to replace google.protobuf.Timestamp to enable traits for de/serialization and for generating documentation
            - `nanos` integer, required
            - `seconds` integer, required
          - `estimated_power_consumption` Power
            - `watt` integer, required
          - `measured_hashrate` GigaHashrate
            - `gigahash_per_second` number, double, required
          - `target` Power
            - `watt` integer, required
    - object
      - `hashratetargetmodestate` HashrateTargetModeState, required
        - `current_target` TeraHashrate
          - `terahash_per_second` number, double, required
        - `profile` HashrateTargetProfile: Structure to handle hashrate target profile
          - `created` Timestamp: Custom version of google.protobuf.Timestamp It is used only during compilation to replace google.protobuf.Timestamp to enable traits for de/serialization and for generating documentation
            - `nanos` integer, required
            - `seconds` integer, required
          - `estimated_power_consumption` Power
            - `watt` integer, required
          - `measured_hashrate` GigaHashrate
            - `gigahash_per_second` number, double, required
          - `target` TeraHashrate
            - `terahash_per_second` number, double, required
  - `overall_tuner_state` integer, required: Tuner state

---

[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)