---
title: "🛡️ Get the current user's all libraries."
method: GET
path: "/api/v1/libraries"
tags: ["Libraries"]
---

# 🛡️ Get the current user's all libraries.

`GET /api/v1/libraries`

<h3>🛡️ Requires Capabilities: <code>Libraries.Read</code></h3>

## Response `200`

- Library[]
  - `id` number, required
  - `libraryId` string, required
  - `name` string, required
  - `paths` string[], required
  - `user` User, required
    - `userId` string, required
    - `cardinalId` string
    - `cachedCloudUser` object, required
      - `subscription` 'free' | 'early_adopter' | 'starter' | 'pro' | 'ultimate'
    - `cachedCloudUserAt` string, date-time
    - `enabled` boolean
    - `role` string, required
    - `designation` string
    - `activityStatus` string
    - `activityStatusUpdatedAt` string, date-time
    - `roles` RoleAssignment[], required
      - `id` number, required
      - `user` User, required — recursive
      - `role` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `deletedAt` string, date-time, required
    - `username` string
    - `password` string
    - `id` number, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `deletedAt` string, date-time, required
  - `playbackQueues` PlaybackQueue[], required
    - `queueId` string, required
    - `user` User, required
      - `userId` string, required
      - `cardinalId` string
      - `cachedCloudUser` object, required
        - `subscription` 'free' | 'early_adopter' | 'starter' | 'pro' | 'ultimate'
      - `cachedCloudUserAt` string, date-time
      - `enabled` boolean
      - `role` string, required
      - `designation` string
      - `activityStatus` string
      - `activityStatusUpdatedAt` string, date-time
      - `roles` RoleAssignment[], required
        - `id` number, required
        - `user` User, required — recursive
        - `role` string, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `deletedAt` string, date-time, required
      - `username` string
      - `password` string
      - `id` number, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `deletedAt` string, date-time, required
    - `type` object, required
    - `dynamicType` object, required
    - `seedMediaType` string
    - `seedMediaId` string
    - `libraries` Library[], required
    - `items` PlaybackQueueItem[]
      - `queueItemId` string, required
      - `queue` PlaybackQueue, required — recursive
      - `history` MusicHistory
        - `playbackEntryId` string, required
        - `progress` number, required
        - `track` MusicTrack, required
          - `file` File, required
            - `user` User, required
              - …
            - `run` Run, required
              - …
            - `musicTrack` MusicTrack[]
            - `photo` Photo
              - …
            - `fileId` string, required
            - `jobTasks` JobTask[], required
              - …
            - `absolutePath` string, required
            - `relativePath` string, required
            - `mimeType` string
            - `extension` string, required
            - `app` string, required
            - `mediaType` string, required
            - `size` number, required
            - `mtime` string, date-time
            - `lastSeen` string, date-time, required
            - `id` number, required
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `deletedAt` string, date-time, required
          - `artists` MusicArtist[], required
            - `tracks` MusicTrack[]
            - `releases` MusicRelease[]
              - …
            - `musicArtistId` string, required
            - `name` string
            - `sortName` string
            - `metadata` MusicArtistMetadata[]
              - …
            - `id` number, required
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `deletedAt` string, date-time, required
          - `release` MusicRelease, required
            - `tracks` MusicTrack[]
            - `artist` MusicArtist
              - …
            - `artists` MusicArtist[]
              - …
            - `genres` MusicGenre[]
              - …
            - `musicReleaseId` string, required
            - `title` string
            - `sortTitle` string
            - `releaseType` 'album' | 'ep' | 'single' | 'compilation' | 'soundtrack' | 'live' | 'remix' | 'dj-mix' | 'broadcast' | 'demo'
            - `metadata` MusicReleaseMetadata[]
              - …
            - `thumbnails` MusicReleaseThumbnail[]
              - …
            - `id` number, required
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `deletedAt` string, date-time, required
          - `musicTrackId` string, required
          - `title` string
          - `sortTitle` string
          - `trackNumber` number
          - `discNumber` number
          - `duration` number
          - `bitrate` number
          - `metadata` MusicTrackMetadata[]
            - `track` MusicTrack, required — recursive
            - `metadataType` object
            - `metadataFormat` object
            - `metaKey` string, required
            - `metaValue` string
            - `id` number, required
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `deletedAt` string, date-time, required
          - `history` MusicHistory[]
          - `waveform` MusicTrackWaveform
            - `track` MusicTrack, required — recursive
            - `version` number, required
            - `binCount` number, required
            - `data` object, required
            - `integratedLufs` number
            - `truePeakDb` number
            - `silenceLeadIn` number
            - `silenceLeadOut` number
            - `id` number, required
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `deletedAt` string, date-time, required
          - `id` number, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `deletedAt` string, date-time, required
        - `queueItem` PlaybackQueueItem — recursive
        - `user` User, required
          - `userId` string, required
          - `cardinalId` string
          - `cachedCloudUser` object, required
            - `subscription` 'free' | 'early_adopter' | 'starter' | 'pro' | 'ultimate'
          - `cachedCloudUserAt` string, date-time
          - `enabled` boolean
          - `role` string, required
          - `designation` string
          - `activityStatus` string
          - `activityStatusUpdatedAt` string, date-time
          - `roles` RoleAssignment[], required
            - `id` number, required
            - `user` User, required — recursive
            - `role` string, required
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `deletedAt` string, date-time, required
          - `username` string
          - `password` string
          - `id` number, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `deletedAt` string, date-time, required
        - `id` number, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `deletedAt` string, date-time, required
      - `mediaType` string, required
      - `mediaId` string, required
      - `position` number, required
      - `id` number, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `deletedAt` string, date-time, required
    - `id` number, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `deletedAt` string, date-time, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `deletedAt` string, date-time, required

## Other responses

- `401` — Possible reasons: The authorization token is invalid.
- `403` — Possible reasons: The user does not have sufficent capabilities.

---

[API](https://skmtc.net/cardinalapps/apis/cardinal-media-server-api.md) · [All operations](https://skmtc.net/cardinalapps/apis/cardinal-media-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cardinalapps/cardinal-media-server-api/revisions/0c30e5146acd/schema)