---
title: "Get app usage details"
method: GET
path: "/workspaces/{workspace_id}/app-usage"
tags: ["App Usage"]
---

# Get app usage details

`GET /workspaces/{workspace_id}/app-usage`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/app-usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Retrieve app usage and storage details for the workspace

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.

## Query parameters

- `fields` string: Fields to return. Can be (current_storage,max_storage_allowed)

## Response `200`

App usage

- AppUsageSchema
  - `workspace` AppUsageFieldSchema, required
    - `storage_used` integer, nullable: Total storage used by the workspace
    - `current_storage_allowed` integer, nullable: Current storage allowed for the workspace
    - `plan_storage_value` integer, nullable: Initial storage offered by the plan
    - `max_storage_allowed` integer, nullable: Maximum storage allowed that can be allowed for the workspace with current plan and addons
    - `row_count_utilized` integer, nullable: Total row count utilized by the workspace
    - `current_row_count_allowed` integer, nullable: Current row count allowed for the workspace
    - `plan_row_count_value` integer, nullable: Initial row count offered by the plan
    - `max_row_count_allowed` integer, nullable: Maximum row count allowed that can be allowed for the workspace with current plan and addons

## Other responses

- `400`: Bad Request
- `401`: Authorization error

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)