---
title: "Get Prompts"
method: GET
path: "/api/v1/prompts"
tags: ["Basics"]
---

# Get Prompts

`GET /api/v1/prompts`

Returns all prompts for a specific website. You can optionally filter by status (active or paused). The prompts returned include metadata such as monthly search volume and total value.

## Query parameters

- `website_id` string, uuid, required
- `status` 'active' | 'paused'
- `prompt_tags` string[]
- `prompt_tags_operator` 'is_any_of' | 'has_all_of'

## Response `200`

Successful response with list of prompts

- object
  - `prompts` Prompt[], required
    - `id` string, uuid, required — Unique identifier for the prompt
    - `prompt` string, required — The prompt text used for content generation
    - `topic_name` string, nullable — The name of the topic category this prompt belongs to
    - `current_monthly_searches` integer — Estimated monthly search volume for this prompt. The keyword-volume provider only measures volume above a floor of ~100/mo; prompts below that floor are returned as 100.
    - `current_total_value` number, nullable — Estimated total monthly value for this prompt
    - `status` 'active' | 'paused', required — Current status of the prompt
    - `country` string, required — Deprecated. Use `countries` instead. Returns the primary country if one is marked primary, otherwise the alphabetically first country. Falls back to `"United States"` when the prompt has no countries.
    - `countries` object[], required — All target countries for the prompt. The primary country (if any) is listed first; remaining countries follow in alphabetical order. Empty when the prompt has no countries assigned.
      - `country` string, required — Country name
      - `is_primary` boolean, required — Whether this is the prompt's primary country. At most one country per prompt is primary.
    - `tags` PromptTag[], required — Tags assigned to the prompt, sorted case-insensitively by name. Empty when the prompt has no tags. Tag IDs can be passed to the `prompt_tags` filter on this endpoint or to `tag_ids` on POST /api/v1/prompts. List a website's full tag catalog with GET /api/v1/prompt-tags.
      - `id` string, uuid, required — Unique identifier for the tag
      - `name` string, required — Tag name

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - You don't have access to this website
- `429` — Too many requests - Rate limit exceeded. Retry after a short delay.
- `500` — Internal server error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/revisions/6c5d71622cb9/schema)