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

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

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

## Request

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

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `range` string, nullable
- `from` string, date, nullable
- `to` string, date, nullable
- `compare` string, nullable
- `compare_from` string, date, nullable
- `compare_to` string, date, nullable
- `granularity` string, nullable

## Response `200`

Successful Response

- object
  - `project_id` string, uuid, required
  - `range` string, required
  - `granularity` string, required
  - `compare` string, required
  - `selected` PerformanceWindow, required
    - `snapshot_id` string, uuid, nullable, required
    - `window_start` string, required
    - `window_end` string, required
    - `evidence_state` 'not_run' | 'observed_zero' | 'available', required
    - `totals` object, required
      - `clicks` integer, nullable, required
      - `impressions` integer, nullable, required
      - `ctr` number, nullable, required
      - `position` number, nullable, required
      - `sessions` integer, nullable, required
      - `key_events` number, nullable, required
    - `series` object, required
      - `clicks` object[], required
        - `date` string, required
        - `value` number, nullable, required
      - `impressions` object[], required
        - `date` string, required
        - `value` number, nullable, required
      - `ctr` object[], required
        - `date` string, required
        - `value` number, nullable, required
      - `position` object[], required
        - `date` string, required
        - `value` number, nullable, required
  - `comparison` PerformanceWindow, required
    - `snapshot_id` string, uuid, nullable, required
    - `window_start` string, required
    - `window_end` string, required
    - `evidence_state` 'not_run' | 'observed_zero' | 'available', required
    - `totals` object, required
      - `clicks` integer, nullable, required
      - `impressions` integer, nullable, required
      - `ctr` number, nullable, required
      - `position` number, nullable, required
      - `sessions` integer, nullable, required
      - `key_events` number, nullable, required
    - `series` object, required
      - `clicks` object[], required
        - `date` string, required
        - `value` number, nullable, required
      - `impressions` object[], required
        - `date` string, required
        - `value` number, nullable, required
      - `ctr` object[], required
        - `date` string, required
        - `value` number, nullable, required
      - `position` object[], required
        - `date` string, required
        - `value` number, nullable, required
  - `coverage` object, required
    - `earliest_date` string, nullable, required
    - `latest_date` string, nullable, required
    - `covered_days` integer, required
    - `analytics_quality` object, required
  - `dimension_counts` object, required
    - `query` integer, required
    - `page` integer, required
    - `country` integer, required
    - `device` integer, required
    - `search_appearance` integer, required
    - `day` integer, required
    - `bing_query` integer, required
    - `bing_page` integer, required
  - `unavailable_dimensions` string[], required
  - `formula_version` string, required
  - `normalization_version` 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)