For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETGet usage statistics
      • GETGet daily execution usage
Dashboard
LogoLogo
Runtype APIUsage Limits

Get usage statistics

GET
/v1/usage-limits
GET
/v1/usage-limits
$curl https://api.runtype.com/v1/usage-limits \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "usage": {
3    "atSpendLimit": true,
4    "isNearLimit": true,
5    "isOverLimit": true,
6    "isUnlimited": false,
7    "month": "2024-06",
8    "percentUsed": 33.3,
9    "platformTokenLimit": 500000,
10    "platformTokensUsed": 166500,
11    "remaining": 833500,
12    "spendLimit": 1500,
13    "spendLimitEnabled": true,
14    "userId": "user_1234567890abcdef",
15    "daily": {
16      "atSpendLimit": true,
17      "date": "2024-06-15",
18      "executionLimit": 1000,
19      "executionsUsed": 1000,
20      "inSlowMode": true,
21      "isAtLimit": true,
22      "isNearLimit": true,
23      "isOverage": true,
24      "isUnlimited": false,
25      "overageCount": 5,
26      "percentUsed": 100,
27      "periodType": "daily",
28      "remaining": 0,
29      "resetsAt": "2024-06-16T00:00:00Z",
30      "spendLimit": 50,
31      "spendLimitEnabled": true,
32      "tier": "pro"
33    },
34    "monthly": {
35      "atSpendLimit": false,
36      "date": "2024-06-01",
37      "executionLimit": 30000,
38      "executionsUsed": 15000,
39      "inSlowMode": false,
40      "isAtLimit": false,
41      "isNearLimit": false,
42      "isOverage": false,
43      "isUnlimited": false,
44      "overageCount": 0,
45      "percentUsed": 50,
46      "periodType": "monthly",
47      "remaining": 15000,
48      "resetsAt": "2024-07-01T00:00:00Z",
49      "spendLimit": 1500,
50      "spendLimitEnabled": true,
51      "tier": "pro"
52    }
53  }
54}

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

Was this page helpful?
Previous

Get daily execution usage

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Response

Usage statistics
usageobject

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error