---
title: "Fetch suggestion lists"
method: GET
path: "/api/v1/suggestion_lists"
tags: ["Questionnaires"]
---

# Fetch suggestion lists

`GET /api/v1/suggestion_lists`

## Request

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

Lists the business's suggestion lists, ordered by title. A suggestion list is the set of songs a questionnaire's `song` or `song_list` question lets a customer pick from — the question names one through its `suggestionListId`.

The songs themselves are not returned here, only `title` and `item_count`. A list holds up to 1000 songs and a business can have many, so fetch a single list when you need what is on it.

Deleted lists are never returned, and only lists the business owns are listed.

**Required permission:** `planning_read`.

## Headers

- `Api-Key` string, required

## Response `200`

suggestion lists found

---

[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)