---
title: "GET /v1/projects/{project_id}/visibility/prompts"
method: GET
path: "/v1/projects/{project_id}/visibility/prompts"
tags: ["visibility"]
---

# GET /v1/projects/{project_id}/visibility/prompts

`GET /v1/projects/{project_id}/visibility/prompts`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/visibility/prompts`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `audit_id` string, uuid, nullable
- `audit_ids` string[], nullable
- `market` string, uuid, nullable
- `baseline_audit_ids` string[], nullable
- `engine` string, nullable
- `baseline_id` string, uuid, nullable
- `cohort` 'core' | 'comparison' | 'all'

## Response `200`

Successful Response

- PromptMetricItem[]
  - `id` string, uuid, required
  - `audit_id` string, uuid, required
  - `prompt_id` string, uuid, nullable, required
  - `prompt_index` integer, required
  - `prompt_text` string, required
  - `prompt_snapshot_id` string, uuid, nullable
  - `cohort` string, required
  - `composite_score` number, nullable, required
  - `source_audit_ids` string[]
  - `previous_score` number, nullable, required
  - `immediate_delta` number, nullable, required
  - `rolling_four` number[], required
  - `per_engine_scores` object, required
  - `components` object, required
  - `engine_agreement` number, required
  - `repetition_agreement` number, required
  - `evidence_coverage` number, required
  - `trend_confidence` number, required
  - `decline_confirmed` boolean, required
  - `analyzer_version` string, required
  - `scoring_rule_version` string, required
  - `created_at` string, required
  - `theme` string
  - `intent` string
  - `visibility_rate` number, nullable
  - `owned_citation_rate` number, nullable
  - `avg_position` number, nullable
  - `visibility_delta` number, nullable
  - `comparison_status` string
  - `comparison` VisibilityComparison
    - `status` string, required
    - `baseline_audit_id` string, uuid, nullable, required
    - `baseline_audit_ids` string[], required
    - `baseline_at` string, nullable, required
    - `baseline_counts` MeasurementCounts, required
      - `state` string, required
      - `responses` integer, required
      - `brand_responses` integer, nullable, required
      - `owned_citation_responses` integer, nullable, required
      - `entity_presences` integer, nullable, required
      - `expected` integer, nullable, required
      - `failed` integer, nullable, required
      - `not_run` integer, nullable, required
    - `current_counts` MeasurementCounts, required
      - `state` string, required
      - `responses` integer, required
      - `brand_responses` integer, nullable, required
      - `owned_citation_responses` integer, nullable, required
      - `entity_presences` integer, nullable, required
      - `expected` integer, nullable, required
      - `failed` integer, nullable, required
      - `not_run` integer, nullable, required
    - `deltas` object, required
    - `rankings` RankingRow[], required
      - `name` string, required
      - `is_brand` boolean, required
      - `logo_url` string, nullable
      - `website_url` string, nullable
      - `mention_rate` number, nullable, required
      - `citation_rate` number, nullable, required
      - `share_of_voice` number, nullable, required
      - `mention_count` integer, required
      - `visibility_delta` number, nullable
      - `gap_count` integer, nullable
      - `matched_visibility_rate` number, nullable
      - `matched_visibility_delta` number, nullable
      - `matched_response_count` integer, nullable
      - `avg_position` number, nullable, required
    - `skipped_runs` integer, required
    - `matched_cells` integer, required
    - `current_cells` integer, required
    - `baseline_cells` integer, required
    - `current_values` object, required
    - `baseline_values` object, required
    - `current_rankings` RankingRow[], required
      - `name` string, required
      - `is_brand` boolean, required
      - `logo_url` string, nullable
      - `website_url` string, nullable
      - `mention_rate` number, nullable, required
      - `citation_rate` number, nullable, required
      - `share_of_voice` number, nullable, required
      - `mention_count` integer, required
      - `visibility_delta` number, nullable
      - `gap_count` integer, nullable
      - `matched_visibility_rate` number, nullable
      - `matched_visibility_delta` number, nullable
      - `matched_response_count` integer, nullable
      - `avg_position` number, nullable, required
  - `counts` MeasurementCounts
    - `state` string, required
    - `responses` integer, required
    - `brand_responses` integer, nullable, required
    - `owned_citation_responses` integer, nullable, required
    - `entity_presences` integer, nullable, required
    - `expected` integer, nullable, required
    - `failed` integer, nullable, required
    - `not_run` integer, nullable, required
  - `answer_states` AnswerStates
    - `mentioned_and_cited` integer, required
    - `mentioned_only` integer, required
    - `cited_only` integer, required
    - `neither` integer, required
  - `action_id` string, uuid, nullable
  - `outcomes` object[]
    - `logical_engine` string, required
    - `transport_model` string, required
    - `counts` MeasurementCounts, required
      - `state` string, required
      - `responses` integer, required
      - `brand_responses` integer, nullable, required
      - `owned_citation_responses` integer, nullable, required
      - `entity_presences` integer, nullable, required
      - `expected` integer, nullable, required
      - `failed` integer, nullable, required
      - `not_run` integer, nullable, required
    - `visibility_rate` number, nullable, required
    - `owned_citation_rate` number, nullable, required
    - `answer_states` AnswerStates
      - `mentioned_and_cited` integer, required
      - `mentioned_only` integer, required
      - `cited_only` integer, required
      - `neither` integer, required
    - `gap_counts` object, required

---

[API](https://skmtc.dev/citeladder/apis/citeladder-api.md) · [All operations](https://skmtc.dev/citeladder/apis/citeladder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/citeladder/apis/citeladder-api/revisions/8c9f6aea40c2?raw)