docs

Usage

Tenant-scoped usage meters and effective limits for the authenticated tenant.

On this page

Get tenant usage

Returns current billing period usage counters and plan limits for the authenticated tenant.

Technical details

Exact HTTP method and path your client calls

get/billing/usage

Responses

Tenant usage meters and effective plan limits for the authenticated tenant

FieldTypeDescription
requiredobject
requiredobject
Example
{
  "usage": {
    "workspaceCount": 0,
    "userSeatCount": 0,
    "apiCallsInWindow": 0,
    "aiTagsInWindow": 0,
    "windowStart": "2026-01-01T00:00:00.000Z",
    "windowEnd": "2026-01-01T00:00:00.000Z"
  },
  "effectiveLimits": {
    "maxWorkspaces": 0,
    "maxApiCalls": 0,
    "quotaWindow": "per_utc_day",
    "maxUserSeats": 0,
    "aiTagCreditsPerPeriod": 0,
    "entitlements": {}
  }
}

Errors return the standard envelope. See error reference.

Code samples

curl --request GET \
  --url 'https://api.not24get.me/billing/usage' \
  --header 'Authorization: Bearer <your-api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-ID: <workspace-id>'

Try it