---
title: "Get hashboard details"
method: GET
path: "/api/v1/miner/hw/hashboards"
tags: ["Miner"]
---

# Get hashboard details

`GET /api/v1/miner/hw/hashboards`

## Request

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

Retrieves detailed information about all hashboards in the miner, including their status, temperature, voltage, frequency, and statistics.

## Response `200`

Successful response containing a list of hashboards.

- GetHashboardsResponse
  - `hashboards` Hashboard[], required: All HB details
    - `board_name` string, nullable: Hashboard board name
    - `board_temp` Temperature
      - `degree_c` number, double, required
    - `chip_type` string, nullable: Hashboard chip type
    - `chips_count` integer, nullable: Number of chips
    - `current_frequency` Frequency
      - `hertz` number, double, required
    - `current_voltage` Voltage
      - `volt` number, double, required
    - `enabled` boolean, required: Flag if HB is enabled
    - `highest_chip_temp` TemperatureSensor
      - `id` integer, nullable: Sensor id
      - `location` integer, required: Sensor location
      - `temperature` Temperature
        - `degree_c` number, double, required
    - `highest_outlet_temp` Temperature
      - `degree_c` number, double, required
    - `id` string, required: Hashboard ID
    - `lowest_inlet_temp` Temperature
      - `degree_c` number, double, required
    - `model` string, nullable: Hashboard model
    - `serial_number` string, nullable: Hashboard serial number
    - `stats` WorkSolverStats: Structure to handle HB state
      - `best_share` integer, required: Best share (deprecated: may overflow for values > 2^64-1, use best_share_str instead)
      - `best_share_str` string, required: Best share as decimal string
      - `error_hashrate` MegaHashrate
        - `megahash_per_second` number, double, required
      - `found_blocks` integer, required: Found blocks
      - `nominal_hashrate` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `real_hashrate` RealHashrate: Structure which contains HB real hashrate stats.
        - `last_15m` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_15s` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_1h` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_1m` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_24h` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_30m` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_30s` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_5m` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `last_5s` GigaHashrate
          - `gigahash_per_second` number, double, required
        - `since_restart` GigaHashrate
          - `gigahash_per_second` 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)