---
title: "List Groups"
method: GET
path: "/api/v1/campaign-groups"
tags: ["campaign-groups"]
---

# List Groups

`GET /api/v1/campaign-groups`

## Request

- Base URL: `https://app.kaminari.ad`
- URL: `https://app.kaminari.ad/api/v1/campaign-groups`
- Auth: HTTP bearer

List campaign groups with optional name + date filters.

``created_*`` and ``last_run_*`` are inclusive calendar days
interpreted in ``timezone`` (IANA name, defaults to UTC). A group's
last run is the newest run across its campaigns, so a group whose
campaigns have never run is excluded once either last-run bound is
set.

## Query parameters

- `archived` boolean
- `q` string, nullable
- `created_from` string, date, nullable
- `created_to` string, date, nullable
- `last_run_from` string, date, nullable
- `last_run_to` string, date, nullable
- `timezone` string

## Response `200`

Successful Response

- CampaignGroupResponse[]
  - `id` string, uuid, required
  - `name` string, required
  - `is_default` boolean, required
  - `is_archived` boolean, required
  - `schedule_paused` boolean, required
  - `created_at` string, date-time, required
  - `campaign_count` integer, nullable
  - `last_run_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kaminari/apis/kaminari-ad-api.md) · [All operations](https://skmtc.dev/kaminari/apis/kaminari-ad-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaminari/apis/kaminari-ad-api/revisions/013f86e2fd32?raw)