---
title: "Get usage and cost"
method: GET
path: "/v2/teamspaces/{teamspaceId}/usage"
tags: ["Teamspace Admin"]
---

# Get usage and cost

`GET /v2/teamspaces/{teamspaceId}/usage`

## Request

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

Daily requests, parse tokens and costs for the dashboard usage window, with the quota, plan and credit balance. Any member can call it.

## Response `200`

Usage

- TeamspaceUsageResponse
  - `dailyStats` TeamspaceUsageDay[]: Days with activity in the usage window (about 30 days), oldest first; the last entry is today (live).
    - `date` string, date: UTC day.
    - `searchRequests` integer
    - `fetchDocsRequests` integer
    - `parseTokens` integer
    - `memberCount` integer
    - `parseTokensCost` number: USD.
    - `memberCost` number: USD.
    - `apiUsageCost` number: USD, billed API requests.
  - `quotaLimit` integer: Monthly request quota of the teamspace (0 for pay-as-you-go).
  - `ownerPlan` 'free' | 'pro' | 'enterprise'
  - `billingModel` 'seat' | 'payg'
  - `billsUsage` boolean: Requests over the quota (or every request, on pay-as-you-go) are billed.
  - `userRequests` integer: The caller's requests this month.
  - `billedRequests` integer, nullable: Billed requests this month, pay-as-you-go only.
  - `memberRate` number, nullable: USD per seat per month; null when no seat fee applies.
  - `creditBalance` number: Credit balance in USD.
  - `personalMembershipWaived` boolean

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Insufficient permissions or plan restrictions
- `500`: Internal Server Error

## Changes

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

[Operation history](https://skmtc.dev/context7/apis/context7-public-api/changes/v2/teamspaces/:teamspaceId/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)