> ## 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.

# Get the live queue and its metadata



## OpenAPI

````yaml /api-reference/openapi.json get /playlists/{id}
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:
  /playlists/{id}:
    get:
      tags:
        - Playlist (queue)
      summary: Get the live queue and its metadata
      operationId: getPlaylist
      parameters:
        - $ref: '#/components/parameters/IdPath'
      responses:
        '200':
          description: PlaylistInfo
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlaylistInfo'
              example:
                amount: 1
                index: 0
                first_index: 0
                last_insert_pos: 0
                max_playlist_size: 10000
                seed: 0
                last_shuffled_start: 0
                entries:
                  - path: >-
                      /Users/tsirysandratraina/Music/Cannons - All I Need/1.
                      Cannons - All I Need.m4a
                    title: All I Need
                    artist: Cannons
                    album: All I Need
                    albumartist: Cannons
                    composer: ''
                    genre_string: ''
                    tracknum: 1
                    discnum: 1
                    year: 2025
                    year_string: '2025-10-17'
                    length: 227073
                    elapsed: 0
                    filesize: 9083647
                    bitrate: 320
                    frequency: 44100
                    id: cmjhiwtrq002vslny83sh3cpc
                    album_id: cmjhiwtr6002fslnyzl17c1rn
                    artist_id: cmjhiwtqz0003slnyk5x8akqo
                    genre_id: ''
                    album_art: b0cf2a54ef92afc1796c506f641f8b68.jpg
components:
  parameters:
    IdPath:
      name: id
      in: path
      required: true
      schema:
        type: string
  schemas:
    PlaylistInfo:
      type: object
      properties:
        amount:
          type: integer
          format: int32
        index:
          type: integer
          format: int32
        max_playlist_size:
          type: integer
          format: int32
        first_index:
          type: integer
          format: int32
        last_insert_pos:
          type: integer
          format: int32
        seed:
          type: integer
          format: int32
        last_shuffled_start:
          type: integer
          format: int32
        entries:
          type: array
          items:
            $ref: '#/components/schemas/Mp3Entry'
    Mp3Entry:
      type: object
      description: Rockbox firmware-side representation of a playing or queued track
      properties:
        path:
          type: string
        title:
          type: string
        artist:
          type: string
        album:
          type: string
        albumartist:
          type: string
        composer:
          type: string
        genre_string:
          type: string
        tracknum:
          type: integer
          format: int32
        discnum:
          type: integer
          format: int32
        year:
          type: integer
          format: int32
        year_string:
          type: string
        length:
          type: integer
          format: int64
          description: Duration in milliseconds
        elapsed:
          type: integer
          format: int64
          description: Current position in milliseconds
        filesize:
          type: integer
          format: int64
        bitrate:
          type: integer
          format: int64
        frequency:
          type: integer
          format: int64
        id:
          type: string
          nullable: true
        album_id:
          type: string
          nullable: true
        artist_id:
          type: string
          nullable: true
        genre_id:
          type: string
          nullable: true
        album_art:
          type: string
          nullable: true

````