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

# Get user playlists

`GET /playlists`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/playlists`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

## Response `200`

The playlists

- Playlist[]
  - `_id` string, required
  - `name` string, required
  - `user_guid` string, required
  - `search_parameters` SearchParameters, required
    - `label_guids` string[], nullable, required
    - `user_guids` string[], nullable, required
    - `tagged_user_guids` string[], nullable, required
    - `channel_guids` string[], nullable, required
    - `begin_date` string, date-time, nullable, required
    - `end_date` string, date-time, nullable, required
    - `heardStatus` 'heard' | 'unheard' | 'any', required
    - `limit` number, nullable, required
  - `image_url` string, nullable, required

---

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