---
title: "Get Hospital Group Usage"
method: GET
path: "/admin/hospital-groups/{hospital_group_id}/usage"
tags: ["Subscriptions"]
---

# Get Hospital Group Usage

`GET /admin/hospital-groups/{hospital_group_id}/usage`

## Request

- Base URL: `https://developer.claimmind.life` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.claimmind.life/admin/hospital-groups/{hospital_group_id}/usage`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

Get aggregated usage for all tenants in a hospital group.

Returns usage data for each tenant in the hospital group,
along with the total usage across all tenants.

**Access:**
- mtk_admin: can view any hospital group
- super_admin: can view only their own hospital group

## Path parameters

- `hospital_group_id` string, required

## Response `200`

Successful Response

- HospitalGroupUsageResponse: Response for hospital group aggregated usage.
  - `hospital_group_id` string, required
  - `tenants` HospitalGroupUsageItem[], required
    - `tenant_id` string, required
    - `tenant_name` string, required
    - `plan_code` string, required
    - `total_usage` integer, required
    - `rawat_jalan_count` integer
    - `rawat_inap_count` integer
  - `total_usage` integer, required
  - `total_rawat_jalan_count` integer
  - `total_rawat_inap_count` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimmind/apis/claimmind-open-api-service.md) - [All operations](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/revisions/ee8bfbeadb8a?raw)