---
title: "Retrieves monthly beneficiary rankings"
method: GET
path: "/api/company_analytic/v1/monthly_beneficiary_rankings"
tags: ["Analytics"]
---

# Retrieves monthly beneficiary rankings

`GET /api/company_analytic/v1/monthly_beneficiary_rankings`

This endpoint generates a ranking of beneficiaries based on their usage frequency within a specific month. It highlights the top users (both holders and dependents), showing their ranking position, total usage count, and the moment the goal was completed.

## Response `200`

returns the monthly beneficiary rankings summary details

- object
  - `data` object[]
    - `key` string
    - `value` string
    - `reference` string
    - `type` string
    - `ranking_position` string
    - `completion_moment` 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.net/totalpass/apis/token-use.md) · [All operations](https://skmtc.net/totalpass/apis/token-use/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/totalpass/token-use/revisions/bc65b4950c7e/schema)