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

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

Python

from chronary import Chronary

client = Chronary()

usage = client.usage.get()
print(f"Plan: {usage.plan}")
print(f"API calls: {usage.api_calls.used}/{usage.api_calls.limit}")
print(f"Agents: {usage.agents.used}/{usage.agents.limit}")

Response 200 OK

{
  "plan": "free",
  "period_start": "2026-04-01T00:00:00.000Z",
  "period_end": "2026-04-30T23:59:59.000Z",
  "agents": { "used": 3, "limit": 3 },
  "calendars": { "used": 7, "limit": 10 },
  "events": { "used": 1842, "limit": 2500 },
  "api_calls": { "used": 12450, "limit": 50000 },
  "webhooks": { "used": 956, "limit": 5000 },
  "availability_queries": { "used": 304, "limit": 10000 },
  "ical_subscriptions": { "used": 2, "limit": 5 },
  "proposals": { "used": 0, "limit": 0 }
}

Response fields

Every metric is returned as { used, limit } where limit is null for unlimited metrics on the Pro and Custom plans.

| Field | Description | |-------|-------------| | plan | Current plan: free, pro, or custom | | period_start | ISO-8601 start of the current billing period | | period_end | ISO-8601 end of the current billing period | | agents | Current agent count vs plan cap | | calendars | Current calendar count vs plan cap | | events | Events created this period vs plan cap | | api_calls | API calls this period vs plan cap | | webhooks | Webhook deliveries this period vs plan cap | | availability_queries | Availability queries this period vs plan cap | | ical_subscriptions | Current iCal subscription count vs plan cap | | proposals | Scheduling proposals created this period vs plan cap |

Exact plan caps are published via GET /v1/plans and documented in Rate Limits & Quotas.