---
title: "Campaign Overview Stats"
method: GET
path: "/v2/campaigns/overview-stats"
tags: ["Campaigns V2"]
---

# Campaign Overview Stats

`GET /v2/campaigns/overview-stats`

Returns per-campaign overview stats (users, conversions, conversion rate, proceeds) for the campaigns list cards, served from a shared edge-cached snapshot with stale-while-revalidate. Requires campaigns:read scope.

## Query parameters

- `application_id` string, required — Application ID (required)
- `date_preset` 'last_24_hours' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days' | 'last_180_days' | 'last_365_days' | 'year_to_date' — Date preset for the stats (default: last_24_hours)
- `environment` 'PRODUCTION' | 'SANDBOX' — Environment for the stats (default: PRODUCTION)
- `refresh` 'true' | 'false' — a string to be decoded into a boolean

## Response `200`

Success

- object
  - `object` 'campaign_overview_stats', required
  - `environment` 'PRODUCTION' | 'SANDBOX', required — Environment the stats were computed for
  - `date_preset` 'last_24_hours' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days' | 'last_180_days' | 'last_365_days' | 'year_to_date', required — Date preset the stats were computed for
  - `computed_at` number, required — Epoch milliseconds when the returned snapshot was produced
  - `data` object, required — Overview stats keyed by campaign ID

## Other responses

- `400` — The request did not match the expected schema
- `401` — No API key was provided in the request
- `403` — The API key does not have permission to perform this action
- `404` — The requested resource was not found
- `429` — Too many requests have been made in a short period
- `500` — An unexpected error occurred on the server

---

[API](https://skmtc.dev/superwall/apis/superwall-api-v2.md) · [All operations](https://skmtc.dev/superwall/apis/superwall-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superwall/superwall-api-v2/revisions/e04f76c478af/schema)