---
title: "Get Usage Stats"
method: GET
path: "/monitoring/usage"
tags: ["Monitoring"]
---

# Get Usage Stats

`GET /monitoring/usage`

Return detailed usage statistics for the monitoring overview.

## Query parameters

- `since` integer, nullable
- `until` integer, nullable
- `group_by` 'api' | 'toolkit' | 'agent' — Grouping dimension for usage statistics.
- `top_limit` integer
- `toolkit_id` string, nullable
- `api_id` string, nullable
- `agent_id` string, nullable
- `status` string, nullable

## Response `200`

Successful Response

- UsageResponse — Full usage statistics response.
  - `bucket_seconds` integer, required
  - `buckets` UsageBucket[], required
    - `avg_ms` number, required
    - `failed` integer, required
    - `success` integer, required
    - `total` integer, required
    - `ts` integer, required
  - `group_by` string, required
  - `since` integer, required
  - `stats` UsageStatsBlock, required — Overall usage statistics for a time window.
    - `active_now` integer, required
    - `avg_ms` number, required
    - `failed` integer, required
    - `p50_ms` number, nullable, required
    - `p95_ms` number, nullable, required
    - `pending` integer, required
    - `success` integer, required
    - `total` integer, required
  - `top` UsageTopRow[], required
    - `avg_ms` number, required
    - `failed` integer, required
    - `key` string, required
    - `label` string, required
    - `success` integer, required
    - `total` integer, required
    - `trend` integer[], required
  - `until` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.net/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/revisions/25c23e262a29/schema)