---
title: "Get Workspace Usage History"
method: GET
path: "/api/v1/workspace/usage/history"
tags: ["workspace"]
---

# Get Workspace Usage History

`GET /api/v1/workspace/usage/history`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/workspace/usage/history`
- Auth: none declared

Get workspace-wide historical usage data.

Aggregates daily API call counts across all workspace members.

Args:
    days: Number of days to retrieve (default: 7, max: 90)

Returns:
    Historical usage data by day

Raises:
    HTTPException: 400 if no workspace selected, 500 on error

## Query parameters

- `days` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- UsageHistoryResponse: Historical usage data.
  - `daily_stats` DailyUsage[], required: Daily usage breakdown
    - `date` string, required: Date in ISO format (YYYY-MM-DD)
    - `count` integer, required: Number of requests on this date
  - `total_requests` integer, required: Total requests in period
  - `period_start` string, required: Start date (YYYY-MM-DD)
  - `period_end` string, required: End date (YYYY-MM-DD)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)