Get usage statistics | Runtype Documentation

{
  "usage": {
    "atSpendLimit": true,
    "isNearLimit": true,
    "isOverLimit": true,
    "isUnlimited": false,
    "month": "2024-06",
    "percentUsed": 33.3,
    "platformTokenLimit": 500000,
    "platformTokensUsed": 166500,
    "remaining": 833500,
    "spendLimit": 1500,
    "spendLimitEnabled": true,
    "userId": "user_1234567890abcdef",
    "daily": {
      "atSpendLimit": true,
      "date": "2024-06-15",
      "executionLimit": 1000,
      "executionsUsed": 1000,
      "inSlowMode": true,
      "isAtLimit": true,
      "isNearLimit": true,
      "isOverage": true,
      "isUnlimited": false,
      "overageCount": 5,
      "percentUsed": 100,
      "periodType": "daily",
      "remaining": 0,
      "resetsAt": "2024-06-16T00:00:00Z",
      "spendLimit": 50,
      "spendLimitEnabled": true,
      "tier": "pro"
    },
    "monthly": {
      "atSpendLimit": false,
      "date": "2024-06-01",
      "executionLimit": 30000,
      "executionsUsed": 15000,
      "inSlowMode": false,
      "isAtLimit": false,
      "isNearLimit": false,
      "isOverage": false,
      "isUnlimited": false,
      "overageCount": 0,
      "percentUsed": 50,
      "periodType": "monthly",
      "remaining": 15000,
      "resetsAt": "2024-07-01T00:00:00Z",
      "spendLimit": 1500,
      "spendLimitEnabled": true,
      "tier": "pro"
    }
  }
}

Get usage statistics for the authenticated user. Returns V3 execution stats with backward-compatible token-style fields. Token usage is tracked via Analytics Engine.

Authentication

AuthorizationBearer

API key or Clerk session token

Response

Usage statistics

usageobject

Errors

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/usage-limits \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"