---
title: "List suggested prompts"
method: GET
path: "/suggested_prompts"
tags: ["Prompts"]
---

# List suggested prompts

`GET /suggested_prompts`

## Request

- Base URL: `https://api.llmpulse.ai/api/v1`
- URL: `https://api.llmpulse.ai/api/v1/suggested_prompts`
- Auth: API key in header `Authorization`

Lists the project's Suggested prompts queue, the same list the app's Suggested Prompts tab shows, oldest first. It holds the suggestions of every generator (website, magic for keyword runs, topic, reddit, paa, reputational, translate, gsc for Search Console, catalog). Pending suggestions by default; status=all also returns accepted (with the prompt they became) and rejected ones. Team members need create access to Prompts, like the app's tab.

## Query parameters

- `project_id` integer, required
- `source` 'website' | 'magic' | 'paa' | 'topic' | 'reddit' | 'reputational' | 'gsc' | 'translate' | 'catalog'
- `status` 'pending' | 'accepted' | 'rejected' | 'all'
- `page` integer
- `per_page` integer

## Response `200`

Paginated suggestions

- SuggestedPromptsResponse
  - `project_id` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required
  - `data` SuggestedPrompt[], required
    - `id` integer, required
    - `prompt` string, required
    - `source` string, required: The generator that wrote it: website, magic (keyword runs), topic, reddit, paa, reputational, translate, gsc (Search Console) or catalog
    - `status` string, required: pending, accepted or rejected
    - `country_code` string, nullable, required
    - `language_code` string, nullable, required
    - `prompt_id` integer, nullable, required: The prompt an accepted suggestion became
    - `accepted_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
  - `request_id` string, required

## Other responses

- `403`: API key belongs to a team member whose permission matrix does not grant this feature
- `404`: Resource not found
- `422`: Invalid parameters

## Changes

- **2026-10-16** `dd090b1e1154`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/suggested_prompts/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) - [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmpulse/apis/llm-pulse-api/revisions/38a31f123641?raw)