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

# List paired Bluetooth devices (Linux only)



## OpenAPI

````yaml /api-reference/openapi.json get /bluetooth/devices
openapi: 3.1.0
info:
  title: Rockbox HTTP API
  version: 1.0.0
  summary: >-
    HTTP REST API for rockboxd — playback, library, playlists, devices,
    settings.
  description: >-
    Rockbox Daemon exposes its full feature surface over HTTP REST on port 6063
    (configurable via `ROCKBOX_TCP_PORT`). It complements the GraphQL API on
    :6062 and the gRPC API on :6061 — all three speak to the same in-process
    state.


    All handlers are defined in `crates/server/src/handlers/` and registered in
    `crates/server/src/lib.rs:run_http_server()`.
  contact:
    name: Rockbox Daemon
    url: https://github.com/tsirysndr/rockboxd
  license:
    name: GPL-2.0
    url: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
servers:
  - url: http://localhost:6063
    description: Default local rockboxd
security: []
tags:
  - name: Albums
  - name: Artists
  - name: Tracks
  - name: Search
  - name: Browse
  - name: Player
  - name: Playlist (queue)
  - name: Saved playlists
  - name: Smart playlists
  - name: Track stats
  - name: Devices
  - name: Settings
  - name: System
  - name: Bluetooth
paths:
  /bluetooth/devices:
    get:
      tags:
        - Bluetooth
      summary: List paired Bluetooth devices (Linux only)
      operationId: getBluetoothDevices
      responses:
        '200':
          description: Devices
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BluetoothDevice'
              example:
                - address: 56:64:C4:EE:EE:7B
                  connected: false
                  name: Beats Studio Pro
                  paired: true
                  rssi: null
                  trusted: true
                - address: D8:E0:E1:13:96:DD
                  connected: false
                  name: '[AV] Samsung Soundbar K450 K-Series'
                  paired: true
                  rssi: null
                  trusted: true
components:
  schemas:
    BluetoothDevice:
      type: object
      properties:
        address:
          type: string
        name:
          type: string
        rssi:
          type: integer
          format: int32
          nullable: true
        paired:
          type: boolean
        connected:
          type: boolean
        trusted:
          type: boolean

````