> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List Miner Reboot Events

> Returns detected miner reboot events for the specified farm. Each event includes miner identity (ip, model, make, serial_number) and before/after snapshots (uptime, hashrate, wattage, temperature, anomaly_flags, mining_mode). Hashrate impact averages use T-30 to T-5 minutes before reboot and T+15 to T+60 minutes after reboot.



## OpenAPI

````yaml /api-reference/openapi-legacy.json get /private-api/v1/{workspace_id}/farms/{farm_id}/reboot-events
openapi: 3.1.0
info:
  title: Nonce Private API
  description: |-
    Nonce Private API documentation - Internal endpoints for system integration

    Generated by NestJS Swagger Module with nestjs-zod
    Scope: Private API endpoints only (/private-api/*)
    Do not edit this file manually - regenerate with: pnpm run docs:openapi
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.nonce.app
    description: Production server
security: []
tags: []
paths:
  /private-api/v1/{workspace_id}/farms/{farm_id}/reboot-events:
    get:
      tags:
        - MinerRebootEvents
      summary: List Miner Reboot Events
      description: >-
        Returns detected miner reboot events for the specified farm. Each event
        includes miner identity (ip, model, make, serial_number) and
        before/after snapshots (uptime, hashrate, wattage, temperature,
        anomaly_flags, mining_mode). Hashrate impact averages use T-30 to T-5
        minutes before reboot and T+15 to T+60 minutes after reboot.
      operationId: listMinerRebootEvents
      parameters:
        - name: workspace_id
          required: true
          in: path
          schema:
            type: string
        - name: farm_id
          required: true
          in: path
          schema:
            type: string
        - name: page
          required: false
          in: query
          description: 'Page number (default: 1)'
          schema:
            minimum: 1
            example: 1
            type: number
        - name: pageSize
          required: false
          in: query
          description: 'Number of items per page (default: 10, max: 10000)'
          schema:
            minimum: 1
            maximum: 10000
            example: 10
            type: number
        - name: miner_id
          required: false
          in: query
          description: Filter by miner ID
          schema:
            type: string
            minLength: 1
        - name: from_time
          required: false
          in: query
          description: Start time filter. Defaults to 7 days ago if not provided.
          schema:
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
            example: '2025-09-07T00:00:00Z'
        - name: to_time
          required: false
          in: query
          description: End time filter. Defaults to now if not provided.
          schema:
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
            example: '2025-09-07T00:00:00Z'
      responses:
        '200':
          description: Successfully retrieved reboot events
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    description: Indicates if the request was successful
                  data:
                    type: array
                    description: Array of items
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          description: Reboot event ID
                        workspace_id:
                          type: string
                          description: Workspace ID
                        farm_id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          description: Farm ID
                        miner_id:
                          type: string
                          description: Miner ID
                        ip:
                          type: string
                          description: Miner IP address at time of query
                        model:
                          description: Miner hardware model (e.g. S19 Pro)
                          type:
                            - string
                            - 'null'
                        make:
                          type: string
                          description: Miner manufacturer (e.g. Bitmain)
                        serial_number:
                          description: Miner serial number
                          type:
                            - string
                            - 'null'
                        period:
                          type: string
                          description: Detection period (ISO 8601)
                        source_task_id:
                          description: >-
                            Matched Nonce reboot task ID; null when no unique
                            task match is available
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          type:
                            - string
                            - 'null'
                        pre_uptime:
                          description: Uptime before reboot (seconds)
                          type:
                            - number
                            - 'null'
                        post_uptime:
                          description: Uptime after reboot (seconds)
                          type:
                            - number
                            - 'null'
                        pre_hashrate:
                          description: Hashrate before reboot (H/s)
                          type:
                            - number
                            - 'null'
                        post_hashrate:
                          description: Hashrate after reboot (H/s)
                          type:
                            - number
                            - 'null'
                        pre_period:
                          description: Pre-reboot snapshot collection time (ISO 8601)
                          type:
                            - string
                            - 'null'
                        post_period:
                          description: Post-reboot snapshot collection time (ISO 8601)
                          type:
                            - string
                            - 'null'
                        pre_wattage:
                          description: Power consumption before reboot (watts)
                          type:
                            - number
                            - 'null'
                        post_wattage:
                          description: Power consumption after reboot (watts)
                          type:
                            - number
                            - 'null'
                        pre_temp:
                          description: Average board temperature before reboot (celsius)
                          type:
                            - number
                            - 'null'
                        post_temp:
                          description: Average board temperature after reboot (celsius)
                          type:
                            - number
                            - 'null'
                        pre_anomaly_flags:
                          description: >-
                            Anomaly bitmask before reboot. Bits: 0=fan, 1=power,
                            2=temperature, 3=hashboard, 4=network, 5=firmware,
                            6=unknown, 8=control_board, 9=pool.
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                          type:
                            - integer
                            - 'null'
                        post_anomaly_flags:
                          description: >-
                            Anomaly bitmask after reboot. Bits: 0=fan, 1=power,
                            2=temperature, 3=hashboard, 4=network, 5=firmware,
                            6=unknown, 8=control_board, 9=pool.
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                          type:
                            - integer
                            - 'null'
                        pre_mining_mode:
                          description: Mining mode before reboot (e.g. normal, sleep, low)
                          type:
                            - string
                            - 'null'
                        post_mining_mode:
                          description: Mining mode after reboot (e.g. normal, sleep, low)
                          type:
                            - string
                            - 'null'
                        created_at:
                          description: Record creation time (ISO 8601)
                          type:
                            - string
                            - 'null'
                        before_avg_hashrate:
                          description: >-
                            Average hashrate 30–5 minutes before reboot (H/s).
                            Null when the window has no performance history or
                            when the same miner has another reboot event within
                            15 minutes.
                          type:
                            - number
                            - 'null'
                        after_avg_hashrate:
                          description: >-
                            Average hashrate 15–60 minutes after reboot (H/s).
                            Null when the window has no performance history or
                            when the same miner has another reboot event within
                            15 minutes.
                          type:
                            - number
                            - 'null'
                      required:
                        - id
                        - workspace_id
                        - farm_id
                        - miner_id
                        - ip
                        - model
                        - make
                        - serial_number
                        - period
                        - source_task_id
                        - pre_uptime
                        - post_uptime
                        - pre_hashrate
                        - post_hashrate
                        - pre_period
                        - post_period
                        - pre_wattage
                        - post_wattage
                        - pre_temp
                        - post_temp
                        - pre_anomaly_flags
                        - post_anomaly_flags
                        - pre_mining_mode
                        - post_mining_mode
                        - created_at
                        - before_avg_hashrate
                        - after_avg_hashrate
                  pagination:
                    type: object
                    description: Pagination metadata
                    properties:
                      total:
                        type: number
                        example: 50
                        description: Total number of items
                      limit:
                        type: number
                        example: 10
                        description: Maximum number of items per page
                      offset:
                        type: number
                        example: 0
                        description: Number of items to skip
                      hasNext:
                        type: boolean
                        example: true
                        description: Whether there are more items after this page
                      hasPrevious:
                        type: boolean
                        example: false
                        description: Whether there are items before this page
                    required:
                      - total
                      - limit
                      - offset
                      - hasNext
                      - hasPrevious
                  error:
                    type: 'null'
                    example: null
                    description: Error object (null on success)
                required:
                  - success
                  - data
                  - pagination
                  - error
        '400':
          description: Bad Request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: 'null'
                    example: null
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details:
                        type: object
                        properties:
                          field_errors:
                            type: array
                            items:
                              type: object
                              properties:
                                path:
                                  type: string
                                message:
                                  type: string
                              required:
                                - path
                                - message
                              additionalProperties: false
                        additionalProperties: {}
                      traceId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - success
                  - data
                  - error
                additionalProperties: false
              example:
                success: false
                data: null
                error:
                  code: VALIDATION_ERROR
                  message: Validation failed
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: 'null'
                    example: null
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details:
                        type: object
                        properties:
                          field_errors:
                            type: array
                            items:
                              type: object
                              properties:
                                path:
                                  type: string
                                message:
                                  type: string
                              required:
                                - path
                                - message
                              additionalProperties: false
                        additionalProperties: {}
                      traceId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - success
                  - data
                  - error
                additionalProperties: false
              example:
                success: false
                data: null
                error:
                  code: UNAUTHORIZED
                  message: Invalid or missing API key
        '403':
          description: Forbidden - Valid API key but insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: 'null'
                    example: null
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details:
                        type: object
                        properties:
                          field_errors:
                            type: array
                            items:
                              type: object
                              properties:
                                path:
                                  type: string
                                message:
                                  type: string
                              required:
                                - path
                                - message
                              additionalProperties: false
                        additionalProperties: {}
                      traceId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - success
                  - data
                  - error
                additionalProperties: false
              example:
                success: false
                data: null
                error:
                  code: FORBIDDEN
                  message: Access denied to workspace
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  data:
                    type: 'null'
                    example: null
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details:
                        type: object
                        properties:
                          field_errors:
                            type: array
                            items:
                              type: object
                              properties:
                                path:
                                  type: string
                                message:
                                  type: string
                              required:
                                - path
                                - message
                              additionalProperties: false
                        additionalProperties: {}
                      traceId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - success
                  - data
                  - error
                additionalProperties: false
              example:
                success: false
                data: null
                error:
                  code: INTERNAL_SERVER_ERROR
                  message: Internal server error
      security:
        - clerk-api-key: []
components:
  securitySchemes:
    clerk-api-key:
      scheme: bearer
      bearerFormat: API Key
      type: http
      description: Clerk Machine API Key for authentication

````