---
title: "Pivot songbook (JSON), toujours disponible apres succes"
method: GET
path: "/jobs/{id}/result/songbook"
tags: ["jobs"]
---

# Pivot songbook (JSON), toujours disponible apres succes

`GET /jobs/{id}/result/songbook`

## Request

- Base URL: `https://jam-jam.org/api/v1`
- URL: `https://jam-jam.org/api/v1/jobs/{id}/result/songbook`
- Auth: one of:
  - HTTP bearer
  - none

Le format d'echange le plus utile pour un agent qui veut MANIPULER
le resultat (accords, paroles, structure) plutot que le presenter :
c'est le pivot canonique de Jam Jam, produit avant tout export
portable. `digest` est un condensat stable du contenu (utile pour
detecter un doublon cote client). Disponible des que `phase: done`,
meme si l'artefact de sortie demande (`output`) etait un fichier
binaire (PDF, MIDI...).

## Response `200`

Songbook JSON

- Songbook
  - `format` 'jam-songbook', required
  - `version` 1, required
  - `digest` string, required
  - `songs` object[], required

## Other responses

- `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`).
- `409`: 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`).
- `410`: 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`).
- `422`: 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)