---
title: "Get Ad Changes Kpis"
method: GET
path: "/ad_changes/kpis"
---

# Get Ad Changes Kpis

`GET /ad_changes/kpis`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/ad_changes/kpis`
- Auth: none declared

## Query parameters

- `date_range[since]` union, required
  - string, date
  - string, date-time
  - string
- `date_range[until]` union
  - string, date
  - string, date-time
  - string
- `tz` string, nullable
- `start_of_week` 0 | 1
- `channel[]` string[], nullable
- `ad_platform_id[]` integer[], nullable
- `change_source[]` ChangeSource[], nullable
- `change_type[]` SemanticChangeType[], nullable
- `object_scope[]` AdChangeObjectScope[], nullable
- `actor[]` string[], nullable
- `loop[]` string[], nullable
- `hide_system` boolean

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable
- `X-Browser-Time-Zone` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- AdChangesKpisResponse
  - `total_changes` integer, required
  - `converge_changes` integer, required
  - `manual_changes` integer, required
  - `system_changes` integer, required
  - `converge_share` number, required
  - `previous` PeriodStats, required
    - `total_changes` integer, required
    - `converge_changes` integer, required
    - `converge_share` number, required
  - `weekly_share_trend` WeekPoint[], required
    - `week_start` string, date-time, required
    - `total_changes` integer, required
    - `converge_changes` integer, required
    - `converge_share` number, required
  - `converge_top_types` TypeCount[], required
    - `change_type` 'create_new' | 'meta_review' | 'kill' | 'create_paused' | 'launch' | 'resurrect' | 'scale_up' | 'pull_back' | 'budget_other' | 'bid_strategy' | 'bid_target' | 'rename' | 'audience' | 'creative' | 'schedule' | 'delivery' | 'other', required: Read-side interpretation of a change, the dashboard's primary vocabulary. Derived in SQL only, by `_semantic_change_type_term` in ad_changes_query.py.
    - `count` integer, required
  - `manual_top_actor` TopActor, required
    - `actor` string, required
    - `count` integer, required
    - `top_types` TypeCount[], required
      - `change_type` 'create_new' | 'meta_review' | 'kill' | 'create_paused' | 'launch' | 'resurrect' | 'scale_up' | 'pull_back' | 'budget_other' | 'bid_strategy' | 'bid_target' | 'rename' | 'audience' | 'creative' | 'schedule' | 'delivery' | 'other', required: Read-side interpretation of a change, the dashboard's primary vocabulary. Derived in SQL only, by `_semantic_change_type_term` in ad_changes_query.py.
      - `count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-02** `da98d7824f8c`: 1 warning, 1 info
  - deleted the `query` request parameter `routine[]`
  - added the new optional `query` request parameter `loop[]`
- **2026-09-24** `d98add9aa6ff`: 1 breaking, 4 warning, 4 info
  - removed the enum value `bid` from the property `anyOf[subschema #1]/items/` of the `query` request parameter `change_type[]`
  - added the new `bid_strategy` enum value to the `converge_top_types/items/change_type` response property for the response status `200`
  - added the new `bid_strategy` enum value to the `manual_top_actor/anyOf[subschema #1: TopActor]/top_types/items/change_type` response property for the response status `200`
  - added the new `bid_target` enum value to the `converge_top_types/items/change_type` response property for the response status `200`
  - …5 more

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/ad_changes/kpis/get.md)

---

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