---
title: "List your suggestions"
method: GET
path: "/v1/suggestions"
tags: ["Suggestions"]
---

# List your suggestions

`GET /v1/suggestions`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/suggestions`
- Auth: API key in header `x-api-key`

Lists the edit suggestions you have submitted and their review status (`pending`, `approved`, or `rejected`), newest first.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successful response

- object
  - `results` Suggestion[], required: Your suggestions, newest first.
    - `id` integer, required: Suggestion ID.
    - `track_id` integer, required: The track the suggestion applies to.
    - `field` 'genre', required: Which field is being corrected. Genre is the only field open to suggestions today.
    - `proposed_value` object, required: What you proposed.
      - `genre_id` integer, required: The suggested genre's ID.
      - `genre_name` string, required: The suggested genre's name.
    - `current_value` object, required: What the track held when you submitted, kept for context during review.
      - `genre` string[], required: The track's genres at submission time.
      - `subgenre` string[], required: The track's subgenres at submission time.
    - `note` string, nullable, required: Your note to the reviewer. `null` when none was given.
    - `status` 'pending' | 'approved' | 'rejected', required: Review state. New suggestions come back as `pending`.
    - `review_note` string, nullable, required: The reviewer's reply. `null` until reviewed, and often after.
    - `created_at` string, required: When you submitted it, ISO-8601 UTC.
    - `reviewed_at` string, nullable, required: When it was reviewed, ISO-8601 UTC. `null` while pending.
  - `next_cursor` string, nullable, required: Pass back as the `cursor` param for the next page. `null` on the last page.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)