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

# List Discovery Suggestions

`GET /v1/discovery/suggestions`

## Request

- Base URL: `https://api.mindfort.app`
- URL: `https://api.mindfort.app/v1/discovery/suggestions`
- Auth: HTTP bearer

Lists candidate targets suggested by Discovery, optionally filtered by status, with cursor pagination.

## Query parameters

- `status` 'pending' | 'accepted' | 'dismissed' | 'superseded'
- `limit` integer
- `cursor` string

## Response `200`

Discovery suggestions

- PublicDiscoverySuggestionList
  - `suggestions` PublicDiscoverySuggestion[], required
    - `id` string, uuid, required
    - `target_value` string, required
    - `canonical_target` string, required
    - `target_type` 'web_app' | 'api' | 'network', required
    - `explanation` string, required
    - `status` 'pending' | 'accepted' | 'dismissed' | 'superseded', required
    - `accepted_target_id` string, uuid, nullable, required
    - `first_suggested_at` string, date-time, required
    - `last_suggested_at` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `next_cursor` string, nullable, required

---

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