> ## Documentation Index
> Fetch the complete documentation index at: https://docs.searchcompany.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Prompts

> Retrieve prompts with visibility status for the dashboard

Gets prompts for a business along with their visibility status across AI platforms. Used to populate the "Tracked Queries" table in the dashboard.

**Sorting**: Prompts are sorted by `last_tested_at DESC NULLS LAST`, so recently tested prompts appear first, followed by untested prompts.

## Path Parameters

<ParamField path="org_slug" type="string" required>
  The Clerk organization slug
</ParamField>

## Query Parameters

<ParamField query="product_id" type="string">
  Filter by product/item ID. Use `"business"` for business-only prompts.
</ParamField>

<ParamField query="entity_ids" type="string">
  Comma-separated entity IDs to filter by (for multi-select)
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Maximum prompts to return
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Pagination offset
</ParamField>

## Response

<ResponseField name="org_slug" type="string">
  The organization slug
</ResponseField>

<ResponseField name="product_id" type="string">
  Product ID if filtered
</ResponseField>

<ResponseField name="prompts" type="array">
  Array of prompt objects
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of prompts
</ResponseField>

<ResponseField name="limit" type="integer">
  Limit used
</ResponseField>

<ResponseField name="offset" type="integer">
  Offset used
</ResponseField>

### Prompt Object

| Field            | Type    | Description                                       |
| ---------------- | ------- | ------------------------------------------------- |
| `id`             | integer | Prompt database ID                                |
| `entity_id`      | string  | Entity UUID this prompt belongs to                |
| `query`          | string  | The prompt text                                   |
| `platforms`      | object  | Visibility status per platform                    |
| `last_tested_at` | string  | ISO timestamp of last test (null if never tested) |

### Platforms Object

Each platform has a boolean indicating if the business was mentioned:

* `true` (✓): Entity was found/recommended
* `false` (✗): Entity was not found
* `null` (-): Not yet tested

Platforms:

* `chatgpt` - ChatGPT visibility
* `gemini` - Google Gemini visibility
* `claude` - Anthropic Claude visibility
* `perplexity` - Perplexity AI visibility
* `copilot` - Microsoft Copilot visibility
* `deepseek` - DeepSeek visibility
* `grok` - xAI Grok visibility
* `google_ai` - Google AI visibility

<ResponseExample>
  ```json Response theme={null}
  {
    "org_slug": "nike",
    "product_id": null,
    "prompts": [
      {
        "id": 1,
        "entity_id": "550e8400-e29b-41d4-a716-446655440000",
        "query": "What are the best Nike running shoes for beginners?",
        "platforms": {
          "chatgpt": true,
          "gemini": true,
          "claude": false,
          "perplexity": true,
          "copilot": false,
          "deepseek": false,
          "grok": true,
          "google_ai": true
        },
        "last_tested_at": "2025-12-29T10:30:00Z"
      },
      {
        "id": 2,
        "entity_id": "550e8400-e29b-41d4-a716-446655440000",
        "query": "How does Nike compare to Adidas for basketball shoes?",
        "platforms": {
          "chatgpt": null,
          "gemini": null,
          "claude": null,
          "perplexity": null,
          "copilot": null,
          "deepseek": null,
          "grok": null,
          "google_ai": null
        },
        "last_tested_at": null
      }
    ],
    "total": 50,
    "limit": 100,
    "offset": 0
  }
  ```
</ResponseExample>
