---
title: "Lista kampanii"
method: GET
path: "/campaigns"
tags: ["Kampanie"]
---

# Lista kampanii

`GET /campaigns`

## Request

- Base URL: `https://outreachpilot.pl/api/v1`
- URL: `https://outreachpilot.pl/api/v1/campaigns`
- Auth: HTTP bearer

Kampanie konta od najnowszych, stronicowane kursorem.

**Wymagany zakres klucza:** `campaigns:read`.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'szkic' | 'aktywna' | 'wstrzymana' | 'zakonczona' | 'blad'
- `workspace_id` string

## Response `200`

Sukces.

- object
  - `data` Campaign[], required
    - `id` string, required
    - `name` string, required
    - `status` 'szkic' | 'aktywna' | 'wstrzymana' | 'zakonczona' | 'blad', required
    - `email_account_id` string, nullable, required
    - `daily_limit` integer, required
    - `sending_window_start` string, required
    - `sending_window_end` string, required
    - `track_opens` boolean, required
    - `track_clicks` boolean, required
    - `total_leads` integer, required
    - `total_sent` integer, required
    - `total_opened` integer, required
    - `total_clicked` integer, required
    - `total_replied` integer, required: Uwaga: licznik zbiorczy; odpowiedzi ludzi bez zwrotów daje GET /replies i /campaigns/{id}/stats.
    - `total_bounced` integer, required
    - `started_at` string, nullable, required: Data i czas ISO 8601 (UTC).
    - `completed_at` string, nullable, required: Data i czas ISO 8601 (UTC).
    - `created_at` string, required: Data i czas ISO 8601 (UTC).
    - `updated_at` string, required: Data i czas ISO 8601 (UTC).
  - `pagination` Pagination, required
    - `limit` integer, required: Rozmiar strony użyty w zapytaniu.
    - `has_more` boolean, required: Czy są kolejne strony.
    - `next_cursor` string, nullable, required: Przekaż jako `cursor`, żeby pobrać następną stronę. `null` na ostatniej stronie.

## Other responses

- `401`: Brak, zły, odwołany lub wygasły klucz (`missing_api_key`, `invalid_api_key`, `api_key_revoked`, `api_key_expired`, `account_inactive`).
- `403`: Plan nie obejmuje API (`plan_upgrade_required`, odpowiedź zawiera informacje o planie; nie dotyczy tras wtyczki z kluczem `extension:*`) albo klucz nie ma wymaganego zakresu (`insufficient_scope`).
- `422`: Błąd walidacji. Kody: `validation_error`.
- `429`: Przekroczono limit żądań (`rate_limit_exceeded`). Zobacz nagłówek `Retry-After`.

---

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