---
title: "List catalog prompt suggestions"
method: GET
path: "/catalog_prompt_suggestions"
tags: ["Store Integrations"]
---

# List catalog prompt suggestions

`GET /catalog_prompt_suggestions`

## Request

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

Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from. Team members need read access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).

## Query parameters

- `project_id` integer, required
- `status` 'pending' | 'accepted' | 'rejected'
- `product_external_id` string
- `page` integer
- `per_page` integer

## Response `200`

Paginated suggestions

- CatalogPromptSuggestionsResponse
  - `project_id` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required
  - `data` CatalogPromptSuggestion[], required
    - `id` integer, required
    - `prompt` string, required
    - `status` string, required: pending, accepted or rejected
    - `source` string, required: Always catalog
    - `country_code` string, nullable, required
    - `language_code` string, nullable, required
    - `product` object, required: The catalog product the suggestion was written for
      - `external_id` string, nullable: The store's product id, e.g. gid://shopify/Product/1
      - `handle` string, nullable
      - `title` string, nullable
    - `prompt_id` integer, nullable, required: The tracked prompt an accepted suggestion became; null until accepted
    - `accepted_at` string, date-time, nullable, required: When the suggestion was accepted; null until then
    - `created_at` string, date-time, required
  - `request_id` string, required

## Other responses

- `403`: The account has a white-label portal or an embed, so store integrations are not available (ERR_INTEGRATION_UNAVAILABLE). Writes with a read-only key answer ERR_INSUFFICIENT_SCOPE, and a team member without the permission ERR_INSUFFICIENT_PERMISSION, with the same status
- `404`: Resource not found

## Changes

- **2026-10-04** `8698fcf9df22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/catalog_prompt_suggestions/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)