---
title: "Get Usage"
method: GET
path: "/api/usage"
tags: ["usage"]
---

# Get Usage

`GET /api/usage`

## Request

- Base URL: `https://app.ctlsurf.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ctlsurf.com/api/usage`
- Auth: HTTP bearer

Get current usage stats for the authenticated user.

## Response `200`

Successful Response

- UsageResponse: Current usage stats.
  - `api_calls` integer, required
  - `storage_bytes` integer, required
  - `folders` integer, required
  - `project_skills` integer, required
  - `period_start` string, date, required
  - `limits` TierLimitsResponse, required: Limits for a tier.
    - `api_calls` integer, required
    - `storage_bytes` integer, required
    - `folders` integer, required
    - `project_skills` integer, required
    - `workers` integer, required
  - `api_calls_percent` number, required
  - `storage_percent` number, required
  - `folders_percent` number, required
  - `project_skills_percent` number, required
  - `tier` string, required
  - `in_grace_period` boolean
  - `grace_period_ends` string, date-time, nullable
  - `over_api_calls_limit` boolean
  - `over_storage_limit` boolean
  - `over_folders_limit` boolean
  - `over_project_skills_limit` boolean

---

[API](https://skmtc.dev/ctlsurf/apis/notebook-control-plane.md) · [All operations](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/revisions/ddfbbe20d5ce?raw)