Skip to main content
GET
/
usage
Get Usage
curl --request GET \
  --url https://api.example.com/usage \
  --header 'Authorization: Bearer <token>'
{
  "plan_type": "free",
  "period": "<string>",
  "monthly_session_usage_minutes": 123,
  "monthly_session_count": 123,
  "browser_usage_cost": 123,
  "proxy_usage_cost": 123,
  "proxy_usage_gb": 123,
  "llm_usage_cost": 123,
  "total_cost": 123,
  "monthly_credits_limit": 123,
  "additional_credits": 123,
  "monthly_credits_usage": 123,
  "is_usage_limit_exceeded": true
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-notte-request-origin
string | null
x-notte-sdk-version
string | null

Query Parameters

period
string | null

The montly period to get usage for, i.e May 2025

Response

Successful Response

plan_type
required
Available options:
free,
pro,
growth,
playground,
admin,
minoan,
proofs,
interview
period
string
required
monthly_session_usage_minutes
number
required
monthly_session_count
integer
required
browser_usage_cost
number
required
proxy_usage_cost
number
required
proxy_usage_gb
number
required
llm_usage_cost
number
required
total_cost
number
required
monthly_credits_limit
integer
required
additional_credits
integer
required
monthly_credits_usage
number
required
is_usage_limit_exceeded
boolean
required