---
title: "Get churn cohort analysis"
method: GET
path: "/api/analytics/churn-cohorts"
tags: ["Analytics"]
---

# Get churn cohort analysis

`GET /api/analytics/churn-cohorts`

Monthly cohort retention matrix showing what percentage of each cohort is retained over time.

## Query parameters

- `months` number

## Response `200`

Cohort retention matrix

- ChurnCohortsResponse
  - `months` string[], required
  - `cohorts` CohortRow[], required
    - `month` string, required
    - `totalCustomers` number, required
    - `retentionPercentages` number[], required

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/revisions/0e449a4e0dc8/schema)