---
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
- TypeScript: <https://skmtc.dev/scrunch/apis/scrunch-data-api/docs/:brand_id/prompts/:prompt_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single prompt by its ID, including all associated metadata such as platforms, tags, and topics.

## 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. Returned as the display name of the brand's active stage — one of the brand's default set (`Advice`, `Awareness`, `Evaluation`, `Comparison`, `Other` for intent brands; `Awareness`, `Consideration`, `Conversion`, `Loyalty`, `Other` for funnel brands) or a custom stage name.
  - `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
  - `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-11-03** `e37811b6bc07`: 1 info
  - endpoint added

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

---

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