---
title: "Fetch suggestion list by ID"
method: GET
path: "/api/v1/suggestion_lists/{id}"
tags: ["Questionnaires"]
---

# Fetch suggestion list by ID

`GET /api/v1/suggestion_lists/{id}`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/suggestion_lists/{id}`
- Auth: none declared. Required headers: `Api-Key`

Returns a single suggestion list with every song on it in `data`, in the order the business arranged them. Use this to show a customer what a `song` or `song_list` question offers, or to check what an answer was picked from.

Each item in `data` carries `id`, `name`, `artistName`, `albumName`, `songNotes`, `spotifyUrl`, `youtubeUrl`, `appleMusicUrl` and `soundCloudUrl`. Anything the business left blank is `null`.

**`songNotes` belongs to the list, not to the answer.** It is the business's own note about the song — "requires the clean edit", "played at every reception" — and it is never stored as part of a questionnaire answer. A customer's note about their choice is `selectionNotes` in the questionnaire's `values`.

Recording an answer means writing the song's fields into `values` under the question's `uuid`, along with `songSuggestionListId` set to this list's `id`.

**Required permission:** `planning_read`.

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required

## Response `200`

suggestion list found

- object
  - `data` object
    - `attributes` object
      - `id` integer
      - `title` string: The list's name, as the business set it.
      - `description` string, nullable: The business's own note about what the list is for.
      - `item_count` integer: How many songs are on the list.
      - `data` object[]: The songs on a suggestion list, in the order the business arranged them.
        - `id` string: Identifies the song within this list. Written to an answer as `songId`.
        - `name` string, nullable: The song title.
        - `artistName` string, nullable: The performing artist.
        - `albumName` string, nullable: The album the song is from.
        - `songNotes` string, nullable: The business's own note about the song, shown while choosing. It is part of the list, never part of an answer — a customer's note about their choice is `selectionNotes` in `values`.
        - `spotifyUrl` string, nullable: Link to the song on Spotify.
        - `youtubeUrl` string, nullable: Link to the song on YouTube.
        - `appleMusicUrl` string, nullable: Link to the song on Apple Music.
        - `soundCloudUrl` string, nullable: Link to the song on SoundCloud.

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)