---
title: "Une playlist de mon carnet et ses chansons"
method: GET
path: "/me/playlists/{playlistId}"
tags: ["carnet"]
---

# Une playlist de mon carnet et ses chansons

`GET /me/playlists/{playlistId}`

## Request

- Base URL: `https://jam-jam.org/api/v1`
- URL: `https://jam-jam.org/api/v1/me/playlists/{playlistId}`
- Auth: one of:
  - HTTP bearer
  - none

Les chansons sont rendues en RESUME, dans l'ordre de la playlist, et
paginees par le meme mecanisme de curseur opaque. Une chanson citee
par la playlist mais absente du carnet (supprimee depuis) est
sautee. Playlist inconnue ou appartenant a un autre compte : `404`
indifferencie.

## Path parameters

- `playlistId` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Playlist et ses chansons

- PlaylistDetail
  - `id` string, required
  - `name` string, required
  - `coverEmoji` string, nullable, required
  - `items` CarnetSongSummary[], required
    - `id` string, required: Identifiant stable au carnet (slug artiste-titre).
    - `title` string, required
    - `artist` string, nullable, required
    - `key` string, nullable, required: Tonalite affichee, meme convention que l'export ChordPro (`G`, `Am`...).
    - `capo` number, nullable, required
    - `bpm` number, nullable, required
    - `playlistIds` string[], required: Playlists (plates, multi-appartenance) qui contiennent cette chanson.
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).
- `401`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).
- `403`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).
- `404`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).
- `429`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).

---

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