---
title: "Get analytics insights"
method: GET
path: "/analytics/insights"
tags: ["Analytics"]
---

# Get analytics insights

`GET /analytics/insights`

Returns AI-generated insights for the project over the last `period` days.
Responses are cached on the upstream; pass `force=true` to regenerate.
The `insights[]` array groups observations by type (`critical`, `positive`,
`tip`, `info`) — each item has a short `title`, a longer `body`, and a
suggested `action`.

## Query parameters

- `period` integer
- `force` boolean
- `cached_only` boolean
- `environment` 0 | 1

## Response `200`

Insights payload.

- V4AnalyticsInsights
  - `object` 'analytics_insights', required
  - `url` string, required
  - `generated_at` string, date-time, nullable, required — ISO 8601 timestamp of when the insights were generated.
  - `period_days` integer, required — Window the insights cover, echoed from the `period` query param.
  - `health` 'healthy' | 'watch' | 'critical' | 'null', nullable, required — One-word project health label.
  - `health_score` integer — Integer score — lower is worse.
  - `summary` string, required — One-paragraph plain-English synthesis.
  - `insights` V4AnalyticsInsight[], required
    - `type` 'critical' | 'positive' | 'tip' | 'info', required — Severity / category — drives UI coloring.
    - `metric` string, required — Metric the insight is about (e.g. `mrr`, `new_users`, `user_to_paid_conversion`).
    - `title` string, required
    - `body` string, required — Longer-form observation, 1–3 sentences.
    - `action` string, required — Suggested next step for the operator.
  - `is_cached` boolean — True when the payload came from the upstream cache.
  - `is_stale` boolean — True when a background refresh is in progress and the returned data is an older snapshot.
  - `is_empty` boolean — True when the project has insufficient data to generate insights.

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `403` — Insufficient permissions
- `404` — Not found
- `429` — Too many requests
- `500` — Internal error
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)