---
title: "List campaigns with metrics"
method: GET
path: "/api/v1/reports/campaigns"
tags: ["Reports"]
---

# List campaigns with metrics

`GET /api/v1/reports/campaigns`

## Request

- Base URL: `https://app.convertflow.co`
- URL: `https://app.convertflow.co/api/v1/reports/campaigns`
- Auth: HTTP bearer

## Query parameters

- `website_id` integer
- `timeframe` 'today' | 'this_week' | 'this_month' | 'this_quarter' | 'this_year' | 'last_24_hours' | 'last_7_days' | 'last_30_days' | 'last_90_days' | 'last_365_days' | 'all_time' | 'insights_week' | 'custom'
- `range_start` string, date
- `range_end` string, date
- `count_type` 'distinct' | 'total'
- `previous_period` boolean
- `page` integer
- `per_page` integer
- `sort` 'created_at' | 'published_at' | 'views' | 'conversions' | 'completions' | 'conversion_rate' | 'completion_rate' | 'revenue' | 'aov' | 'custom_goals' | 'bookings'
- `cta_type` string
- `status` 'live' | 'archived'

## Response `200`

count_type=total sums raw views

- object
  - `report` string
  - `website` object
    - `id` integer
    - `name` string
    - `currency` string
  - `timeframe` object
    - `selected` string
    - `range_start` string, date-time
    - `range_end` string, date-time
    - `timezone` string
  - `data` object
    - `campaigns` object[]
      - `id` integer
      - `name` string
      - `cta_type` string: Campaign format
      - `status` string
      - `metrics` object
        - `views` integer
        - `conversions` integer
        - `completions` integer
        - `submissions` integer
        - `subscribes` integer
        - `orders` integer
        - `bookings` integer
        - `custom_goals` integer
        - `revenue` number
        - `conversion_rate` number
        - `completion_rate` number
        - `subscribe_rate` number
        - `order_rate` number
        - `booking_rate` number
        - `custom_goal_rate` number
        - `aov` number
    - `pagination` object
      - `page` integer
      - `per_page` integer
      - `total_entries` integer
      - `total_pages` integer

---

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