---
title: "Liste les chansons de mon carnet"
method: GET
path: "/me/songs"
tags: ["carnet"]
---

# Liste les chansons de mon carnet

`GET /me/songs`

## Request

- Base URL: `https://jam-jam.org/api/v1`
- URL: `https://jam-jam.org/api/v1/me/songs`
- Auth: one of:
  - HTTP bearer
  - none

Instantane pagine du carnet PRIVE de l'appelant, par curseur opaque
(keyset, jamais d'offset), trie par `updatedAt` croissant. Les
chansons supprimees ne sont pas rendues.

`fields=summary` (defaut) rend les metadonnees ; `fields=full` y
ajoute `song`, le payload pivot canonique, exactement le meme objet
que `songs[0]` de l'artefact `GET /jobs/{id}/result/songbook`.

EXPORT INCREMENTAL : garder le plus grand `updatedAt` recu et le
repasser en `updatedSince` au prochain passage. Le filtre est
STRICT (`updatedAt > updatedSince`).

Consomme une unite du compteur de LECTURE (`read` dans
`GET /me/usage`), jamais une conversion.

## Query parameters

- `cursor` string
- `limit` integer
- `updatedSince` string, date-time
- `fields` 'summary' | 'full'

## Response `200`

Page de chansons

- SongPage
  - `items` union[], required
    - union
      - CarnetSongSummary
        - `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
      - CarnetSongFull
        - `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
        - `song` object, required: Payload pivot canonique : le MEME objet que `songs[0]` de l'artefact `GET /jobs/{id}/result/songbook`.
  - `nextCursor` string, nullable, required: A rejouer en `cursor` pour la page suivante ; `null` sur la derniere page.

## 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`).
- `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)