> ## 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 all albums



## OpenAPI

````yaml /api-reference/openapi.json get /albums
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:
  /albums:
    get:
      tags:
        - Albums
      summary: List all albums
      operationId: getAlbums
      responses:
        '200':
          description: Array of albums
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Album'
              example:
                - id: cmodxew8w0053pdmdmro8vx0w
                  title: 2014 Forest Hills Drive
                  artist: J. Cole
                  year: 2014
                  year_string: '2014-12-09'
                  album_art: 216ccc791352fbbffc11268b984db19a.jpg
                  md5: 7efed3c16a2ea54a2c090e40f03107d4
                  artist_id: cmodw19po0005pdmd6k9mwauv
                  label: null
                  copyright_message: ℗ 2014 Cole World/Interscope Records
                - id: cmjodpk0r00j8pdoc5r5eko46
                  title: 21 Reasons (feat. Ella Henderson)
                  artist: Nathan Dawe
                  year: 2019
                  year_string: '2019-05-31'
                  album_art: 53682046896b8c9c6118c169cfd03ff8.jpg
                  md5: 3997d22d81a895c867827ef6f4f83477
                  artist_id: cmjodpk0r00j7pdocuh1vu2vx
                  label: null
                  copyright_message: >-
                    under exclusive licence to Warner Music UK Limited, ℗ 2020
                    Nathan Dawe
components:
  schemas:
    Album:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        artist:
          type: string
        year:
          type: integer
          format: int32
          nullable: true
        year_string:
          type: string
          nullable: true
        artist_id:
          type: string
        md5:
          type: string
        album_art:
          type: string
          nullable: true

````