---
title: "Retrieves monthly gyms rankings summary"
method: GET
path: "/api/companies/v1/analytic/monthly_gyms_rankings"
tags: ["Analytics"]
---

# Retrieves monthly gyms rankings summary

`GET /api/companies/v1/analytic/monthly_gyms_rankings`

## Request

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

This endpoint lists the most popular gyms visited by the company's beneficiaries during the month, ranked by total check-ins. It helps to identify preferred fitness facilities among employees and aids in partnership or location strategy decisions.

## Response `200`

returns the monthly gyms rankings summary details

- object
  - `data` object[]
    - `key` string
    - `reference` string
    - `ranking_position` string
    - `value` string
    - `type` 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)