Usage

Check your organization’s current API call usage, resource counts, and plan limits.

Get usage

GET /v1/usage

No query parameters required. Returns usage for the authenticated organization.

Example

curl https://api.chronary.ai/v1/usage \
  -H "Authorization: Bearer chr_sk_test_your_key_here"

Response 200 OK

{
  "plan": "free",
  "period": {
    "start": "2026-04-01T00:00:00Z",
    "end": "2026-04-30T23:59:59Z"
  },
  "api_calls": {
    "used": 12450,
    "limit": 50000,
    "remaining": 37550
  },
  "resources": {
    "agents": { "used": 3, "limit": 5 },
    "calendars": { "used": 7, "limit": 10 }
  }
}

Response fields

Field	Description
plan	Current plan: free, pro, or scale
period.start	Start of the current billing period
period.end	End of the current billing period
api_calls.used	API calls made this period
api_calls.limit	Monthly API call limit
api_calls.remaining	Remaining API calls
resources.agents	Agent count vs limit
resources.calendars	Calendar count vs limit

Plan limits

Resource	Free	Pro	Scale
Agents	5	50	Unlimited
Calendars	10	100	Unlimited
API calls/month	50,000	500,000	5,000,000