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

# Get Usage

`GET /usage`

## Query parameters

- `period` string, nullable — The montly period to get usage for, i.e May 2025

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Response `200`

Successful Response

- UsageResponse
  - `plan_type` union, required
    - 'free' | 'pro' | 'growth' | 'playground' | 'admin' | 'minoan' | 'proofs' | 'interview'
    - string
  - `period` string, required
  - `session_count` integer, required
  - `function_count` integer, required
  - `browser_usage_cost` number, required
  - `proxy_usage_cost` number, required
  - `llm_usage_cost` number, required
  - `function_usage_cost` number, required
  - `total_cost` number, required
  - `subscription_limit_amount` number, required
  - `topup_limit_amount` number, required
  - `subscription_balance_amount` number, required
  - `topup_balance_amount` number, required
  - `balance_amount` number, required
  - `is_usage_limit_exceeded` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/notte/apis/notte-api.md) · [All operations](https://skmtc.net/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notte/notte-api/revisions/246f6d21de0c/schema)