Organisation usage time series
Public API — Organisation
Organisation usage time series
Daily usage time series for the key’s Live or Test mode (ct_live_… / ct_test_…). Query start / end as YYYY-MM-DD (default last 30 days, max 180-day span).
Responses
| Status | Code | When |
|---|---|---|
200 | — | Mode-scoped series |
403 | PLAN_REQUIRED | Free plan |
Authentication & rate limits (all endpoints)
| Status | Code | When |
|---|---|---|
401 | INVALID_API_KEY | Missing or invalid bearer token |
401 | EXPIRED_API_KEY | API key past its optional expires_at |
403 | INSUFFICIENT_SCOPE | API key lacks the required scope for this operation |
403 | IP_NOT_ALLOWED | Client IP is outside this key’s CIDR allowlist |
429 | RATE_LIMITED | Rate limit exceeded — plan-tiered reads/writes per organisation per hour |
GET
Organisation usage time series
Authorizations
Organisation API key created in Assess → Developer → API Keys. Format: Bearer ct_live_<your-key> (live) or Bearer ct_test_<your-key> (test). Optional per-key CIDR allowlists return 403 IP_NOT_ALLOWED.
Last modified on August 24, 2026