---
title: "GET /v1/playlists"
method: GET
path: "/v1/playlists"
tags: ["Playlists"]
---

# GET /v1/playlists

`GET /v1/playlists`

## Request

- Base URL: `https://api.neume.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neume.io/v1/playlists`
- Auth: none declared

## Query parameters

- `page` number, required
- `limit` number, required

## Response `200`

- ListPlaylistDto
  - `data` ListPlaylistItemDto[], required: List of playlists
    - `playlistId` string, required: Playlist ID
    - `title` string, required: Playlist title
    - `description` string: Playlist description
    - `image` string: Playlist cover image URL
    - `user` PlaylistOwnerDto, required
      - `userId` string, required: User ID
      - `publicName` string: Public display name
      - `firstName` string: First name
      - `lastName` string: Last name
      - `imageUrl` string: Profile image URL
    - `visibility` string, required: Visibility status
    - `songCount` number, required: Number of songs in playlist
    - `isSaved` boolean, required: Whether requesting user has saved this playlist
    - `createdAt` string, date-time, required: Creation date
  - `pagination` PaginationDto, required
    - `page` number, required: Current page number
    - `limit` number, required: Items per page
    - `total` number, required: Total number of items

---

[API](https://skmtc.dev/neume/apis/neume-api.md) · [All operations](https://skmtc.dev/neume/apis/neume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neume/apis/neume-api/revisions/ddfaa546b0be?raw)