---
title: "Retrieves monthly cancellations summary"
method: GET
path: "/api/companies/v1/analytic/monthly_cancellations"
tags: ["Analytics"]
---

# Retrieves monthly cancellations summary

`GET /api/companies/v1/analytic/monthly_cancellations`

## Request

- Base URL: `https://hr.totalpass.com`
- URL: `https://hr.totalpass.com/api/companies/v1/analytic/monthly_cancellations`
- Auth: API key in header `x-api-key`

This endpoint retrieves a statistical summary of cancellations for a specified month, distinguishing between holders and dependents. It is essential for tracking churn rates and understanding retention trends within the company group over time.

## Response `200`

returns the monthly cancellation summary details

- object
  - `data` object[]
    - `key` string
    - `value` integer
    - `reference` string

## Other responses

- `401`: returns unauthorized when api key is invalid
- `404`: returns not found when there is no data
- `422`: returns unprocessable entity on unexpected errors

---

[API](https://skmtc.dev/totalpass/apis/api-companies.md) - [All operations](https://skmtc.dev/totalpass/apis/api-companies/llms.txt) - [OpenAPI document](https://skmtc.dev/totalpass/apis/api-companies/revisions/62259afde09a?raw)