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

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

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

## Request

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

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `audit_id` string, uuid, nullable
- `market` string, uuid, nullable
- `engine` string, nullable
- `baseline_id` string, uuid, nullable
- `selection_mode` 'latest' | 'run' | 'range'
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `configuration_key` string, nullable
- `cohort` 'core' | 'comparison' | 'all'

## Response `200`

Successful Response

- Visibility
  - `project_id` string, uuid, required
  - `audit_id` string, uuid, required
  - `audit_status` 'draft' | 'validating' | 'queued' | 'running' | 'analyzing' | 'reporting' | 'completed' | 'partially_completed' | 'failed' | 'cancelled', required
  - `analyzer_version` string, required
  - `scoring_rule_version` string, required
  - `cohort` 'core' | 'brand_diagnostic' | 'comparison' | 'commerce' | 'all', required
  - `coverage` object, required
  - `total_completed` integer, required
  - `total_failed` integer, required
  - `visibility_score` number, nullable, required
  - `visibility_rate` number, nullable
  - `owned_citation_rate` number, nullable
  - `prompt_performance_score` number, nullable
  - `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
  - `comparison_key` string, nullable
  - `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
  - `citation_totals` object
    - `citations` integer, required
    - `owned_citations` integer, required
    - `owned_share` number, nullable, required
  - `selection_mode` 'latest' | 'run' | 'range'
  - `source_audit_ids` string[]
  - `configuration_groups` object
  - `from_at` string, nullable
  - `to_at` string, nullable
  - `model_provenance` ModelProvenance[], required
    - `logical_engine` string, required
    - `transport_provider` string, required
    - `transport_model` string, required
    - `retrieval_enabled` boolean, nullable, 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
  - `per_engine` VisibilityEngine[], required
    - `logical_engine` string, required
    - `total_completed` integer, required
    - `brand_mention_rate` number, nullable, required
    - `owned_citation_rate` number, nullable, required
    - `search_use_rate` number, nullable, required
    - `visibility_score` 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
  - `avg_position` number, nullable, required
  - `created_at` string, 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)