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

# List prompts

`GET /org/prompts`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/prompts`
- Auth: API key in header `X-API-Key`

Returns one page of your organization's prompts with their tags. Requires the GEO product.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `sort` 'created_desc' | 'created_asc' | 'text_asc' | 'text_desc' | 'type_asc' | 'type_desc'

## Response `200`

One page of prompts.

- OrgPromptListResponse: A paginated list of prompts.
  - `prompts` OrgPromptListItem[], required
    - `prompt_id` string, uuid, required
    - `text` string, required
    - `type` string, required: Funnel stage. Currently one of `decision`, `consideration`, `awareness`, or `evaluation`.
    - `tags` TagResponse[], required
      - `id` string, uuid, required
      - `org_id` string, uuid, required
      - `name` string, required
      - `curated` boolean, required: True = part of the org's working vocabulary; false = machine-minted (from search queries), awaiting adoption.
      - `prompt_count` integer: Prompts carrying this tag.
      - `content_count` integer: Content items carrying this tag.
      - `kb_content_count` integer: Knowledge-base nodes carrying this tag.
      - `generated_content_count` integer: Generated content carrying this tag.
      - `generated_draft_count` integer: Generated drafts carrying this tag.
      - `generated_published_count` integer: Published generated content carrying this tag.
      - `kb_search_message_count` integer: Search queries carrying this tag.
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required: Total prompts matching the query (before pagination).
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)