---
title: "Get agent usage"
method: GET
path: "/v2/teamspaces/{teamspaceId}/sites/{siteId}/agent-usage"
tags: ["Docs7 Sites"]
---

# Get agent usage

`GET /v2/teamspaces/{teamspaceId}/sites/{siteId}/agent-usage`

## Request

- Base URL: `https://context7.com/api`
- URL: `https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}/agent-usage`
- Auth: HTTP bearer

Whether the site reached its monthly agent run limit. Any member. Only for GitHub sites: a CLI site (`source: "local"`) answers 404.

## Path parameters

- `teamspaceId` string, uuid, required
- `siteId` string, uuid, required

## Response `200`

Usage

- object
  - `data` Docs7AgentUsage, required
    - `plan` 'free' | 'pro', required
    - `limitReached` boolean, required: The monthly agent run limit is reached.

## Other responses

- `400`: Invalid teamspace or site id
- `401`: Missing or invalid bearer
- `403`: Not a member, missing role, or an API key of another teamspace
- `404`: No such site in this teamspace
- `500`: Internal error
- `503`: Usage could not be read

## Changes

- **2026-10-22** `e17589fd8767`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context7/apis/context7-public-api/changes/v2/teamspaces/:teamspaceId/sites/:siteId/agent-usage/get.md)

---

[API](https://skmtc.dev/context7/apis/context7-public-api.md) - [All operations](https://skmtc.dev/context7/apis/context7-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/context7/apis/context7-public-api/revisions/945f7834fa8c?raw)