---
title: "Get Prompt"
method: GET
path: "/{brand_id}/prompts/{prompt_id}"
---

# Get Prompt

`GET /{brand_id}/prompts/{prompt_id}`

## Request

- Base URL: `https://api.scrunchai.com/v1`
- URL: `https://api.scrunchai.com/v1/{brand_id}/prompts/{prompt_id}`
- Auth: HTTP bearer

Returns a single prompt by its ID, including all associated metadata such as platforms, tags, and topics. Paused and archived prompts are returned with their lifecycle status; check the field if you only want active ones.

## Path parameters

- `brand_id` integer, required: The unique identifier for the brand
- `prompt_id` integer, required: The unique identifier for the prompt

## Response `200`

Successful Response

- PromptListing: Represents a prompt being tracked for AI visibility, including its configuration and metadata.
  - `id` integer, required: Unique identifier for the prompt
  - `text` string, required: The prompt text being tracked
  - `stage` string, required: The customer journey stage this prompt represents — one of the brand's stages (custom stage names included)
  - `persona_id` integer, nullable, required: ID of the associated persona, if any
  - `platforms` string[], required: AI platforms this prompt is tracked on
  - `tags` string[], required: Custom tags assigned to this prompt
  - `topics` string[], required: Auto-detected or assigned topics for this prompt
  - `branded` boolean, required: Whether this prompt explicitly mentions the brand
  - `favorite` boolean, required: Whether this prompt is marked as a favorite
  - `status` 'active' | 'paused' | 'archived', required: Lifecycle status of the prompt (`active`, `paused`, or `archived`)
  - `created_at` string, date-time, required: Timestamp when the prompt was created

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `fa6217fdd4e1`: 1 warning
  - added the new `deepseek` enum value to the `platforms/items/` response property for the response status `200`
- **2026-08-26** `10f2a17e0cd2`: 1 warning
  - added the new `paused` enum value to the `status` response property for the response status `200`

[Operation history](https://skmtc.dev/scrunchai/apis/scrunch-data-api/changes/:brand_id/prompts/:prompt_id/get.md)

---

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