---
title: "Get Team Usage"
method: GET
path: "/teams/{id}/usage"
tags: ["Teams"]
---

# Get Team Usage

`GET /teams/{id}/usage`

Returns contact usage and capacity for a team.

## Path parameters

- `id` string, uuid, required

## Response `200`

Usage data

- TeamUsageResponse
  - `success` boolean
  - `request_id` string
  - `data` object
    - `team_id` string, uuid
    - `team_name` string
    - `contacts_used` integer
    - `contacts_limit` integer
    - `usage_percentage` number
    - `is_at_limit` boolean

## Other responses

- `403` — Forbidden - Access denied
- `404` — Not Found - Resource does not exist

---

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