Skip to main content
DocumentationDevelopers

Usage and request logs

Read your organization's token usage and the log of every request through the management API.

Documentation menu

Usage and request logs answer on your console's host with the same API key. The key's owner needs the permission usage.read for the whole organization, or usage.read_own for its own requests. The console shows the same data under Usage and Request logs.

Usage summary

export CCSIO_CONSOLE_URL="https://console.us.ccsio.ai"

# Totals per model and per key for October (UTC; "to" is exclusive). Without from and to: the last 7 days.
curl "$CCSIO_CONSOLE_URL/metering/v1/usage/summary?from=2026-10-01T00:00:00Z&to=2026-11-01T00:00:00Z" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

The summary groups the window's usage by model (models), by who made it (by_principal) and by UTC day (series). Narrow it with model_alias, api_key_id, principal or operation_class (inference or tool).

Request logs

One entry per request, newest first, with its status, duration, time to first token, tokens and who made it. Filter by model, api_key_id, team, session, operation or status, and page with cursor:

# One page of the request log, newest first. Pass next_cursor as cursor for the next page.
curl "$CCSIO_CONSOLE_URL/metering/v1/organizations/acme/request-logs?limit=50" \
  -H "Authorization: Bearer $CCSIO_API_KEY"
JSON
{
  "request_id": "req-01k7yqa2c4e6g8j0m2p4r6t8v0",
  "occurred_at": "2026-10-14T16:41:02Z",
  "operation": "chat",
  "http_status": 200,
  "outcome": "success",
  "error_code": null,
  "session_id": "sess-7f3a",
  "api_key_id": "01K7YQ4D8M2P6S9V3X5Z7B1C4F",
  "duration_ms": 1840,
  "ttft_ms": 212,
  "tokens": { "input": 412, "output": 697, "total": 1109 },
  "measurement": "measured",
  "measurement_reason": null,
  "quantities": [
    { "unit": "input_tokens", "amount": "412" },
    { "unit": "output_tokens", "amount": "697" }
  ],
  "end_user": {
    "principal_ref": "svc/01K7YP2C9W4X5E8H3J6M0N1Q2R",
    "principal_class": "service",
    "email": null,
    "display_name": "billing-app"
  },
  "team_id": "platform",
  "model": "qwen3.8-flash-next",
  "attempts": 1
}
One entry of request_logs.
Explore the platform

Get your first API key

Registration is open. Four steps to your first call: create your account, create your organization, create your API key, and start using it.

  1. 01Create your account
  2. 02Create your organization
  3. 03Create your API key
  4. 04Start using it