---
title: "Get team usage"
method: GET
path: "/v1/teams/{teamId}/usage"
tags: ["teams"]
---

# Get team usage

`GET /v1/teams/{teamId}/usage`

Get the MCP request usage of a team for its current billing window. A team that has made no request in the window reports zero.

## Path parameters

- `teamId` string, required — The ID of the team

## Response `200`

The current billing window usage

- object
  - `teamId` string, required
  - `plan` 'pro' | 'business' | 'enterprise', nullable, required — The plan in force for the window, null on the Free plan
  - `periodStart` string, date-time, required — Start of the current billing window
  - `periodEnd` string, date-time, required — End of the current billing window
  - `requestCount` integer, required — MCP requests settled during the current billing window
  - `includedRequests` integer, nullable, required — Requests included in the plan for one window, null when the allowance is contract-specific

## Other responses

- `400` — 400
- `404` — 404

## Changes

- **2026-08-13** `90e2584a7c1c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alpic/apis/alpic-api/changes/v1/teams/:teamId/usage/get.md)

---

[API](https://skmtc.dev/alpic/apis/alpic-api.md) · [All operations](https://skmtc.dev/alpic/apis/alpic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alpic/alpic-api/revisions/262875478562/schema)