---
title: "Get application data"
method: GET
path: "/api/data"
tags: ["data"]
---

# Get application data

`GET /api/data`

Retrieve a set of application data catered for the current authenticated user (songs, albums, artists, playlists, interactions, and if the user is an admin, settings as well). This call should typically be made right after the user is logged in, to populate the application's interface with relevant information.

## Response `200`

OK

- object
  - `albums` Album[], required
    - `id` integer, required
    - `artist_id` integer, required
    - `name` string, required
  - `allowDownload` boolean, required — Whether the current installation of Koel allows downloading
  - `artists` Artist[], required
    - `id` integer, required
    - `name` string, required
  - `cdnUrl` string, uri, required — The CDN URL of the application, if configured
  - `currentUser` User, required — A User model
    - `id` integer, required
    - `name` string, required
    - `email` string, required
    - `is_admin` boolean, required
    - `preferences` object, required
      - `last_fm_session_key` string
  - `currentVersion` string, required — Version of the current installation of Koel
  - `latestVersion` string, required — The latest version of Koel
  - `playlists` Playlist[], required
    - `id` integer, required
    - `name` string, required
    - `rules` Playlist[], required — An array of Rule objects if the playlist is a Smart playlist
    - `is_smart` boolean, required — Whether the playlist is of Smart (dynamic) type
  - `recentlyPlayed` string[], required — An array containing the IDs of the most recently-played songs
  - `settings` object — Settings for the current Koel installation. Only available if the current authenticated user is an admin.
    - `media_path` string, required
  - `songs` Song[], required
    - `id` string, required — An md5 string
    - `artist_id` integer, required
    - `album_id` integer, required
    - `title` string, required
    - `disc` integer, required
    - `track` number, required
    - `length` number, float, required — The duration of the song in seconds
  - `supportsTranscoding` boolean, required — Whether the current installation of Koel supports transcoding media
  - `useLastfm` boolean, required
  - `useYouTube` boolean, required
  - `useiTunes` boolean, required
  - `users` User[] — Only available if the current authenticated user is an admin
    - `id` integer, required
    - `name` string, required
    - `email` string, required
    - `is_admin` boolean, required
    - `preferences` object, required
      - `last_fm_session_key` string
  - `interactions` InteractionExcerpt[], required
    - `song_id` string, required
    - `liked` boolean, required
    - `play_count` integer, required

---

[API](https://skmtc.net/koel/apis/koel-api.md) · [All operations](https://skmtc.net/koel/apis/koel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/koel/koel-api/versions/b8837d22df45/schema)