---
title: "List Next Steps"
method: GET
path: "/v3/next-steps"
tags: ["Next Steps"]
---

# List Next Steps

`GET /v3/next-steps`

Returns a team's recommended steps. Defaults to the open list (status open/doing) ordered by priority, with the team's refresh settings. Pass wins=true for resolved steps, includeDone=true to get them alongside the open list, or subjectType/subjectId to filter to a subject.

## Query parameters

- `teamId` string
- `limit` integer
- `subjectType` 'team' | 'keyword' | 'topic' | 'article' | 'page' | 'prompt' | 'domain'
- `subjectId` string
- `wins` 'true' | 'false'
- `includeDone` 'true' | 'false'

## Response `200`

Default Response

## Changes

- **2026-09-22** `623d4784f6e6` — 1 info
  - added the new optional `query` request parameter `includeDone`
- **2026-09-18** `e0163b1c37cb` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/next-steps/get.md)

---

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