---
title: "Get Usage"
method: GET
path: "/v1/usage"
tags: ["Scouting"]
---

# Get Usage

`GET /v1/usage`

Get usage statistics over different time periods, active scouts, and rate limits.

## Query parameters

- `period` '24h' | '7d' | '30d' | '90d'

## Response `200`

Successful Response

- UsageResponse
  - `num_active_scouts` integer, required
  - `active_scout_ids` string[], required
  - `rate_limits` RateLimits, required
    - `requests_today` integer, nullable, required — API requests used today (None if unavailable)
    - `daily_limit` integer, nullable, required — Daily request limit from AWS API Gateway usage plan (None if unavailable)
    - `remaining_requests` integer, nullable, required — Remaining requests for today (None if unavailable)
    - `reset_at` string, required — ISO 8601 timestamp for next midnight UTC
    - `status` 'available' | 'unavailable', required — Rate limit availability status
  - `navigator_rate_limits` NavigatorRateLimits, required — Rate limits for the Navigator (chat completions) endpoint.
    - `requests_today` integer, required — Navigator API requests used today (since midnight UTC)
    - `daily_limit` integer, required — Daily Navigator request limit (resets at midnight UTC)
    - `remaining_requests` integer, required — Remaining Navigator requests for today (daily_limit - requests_today)
    - `reset_at` string, required — ISO 8601 timestamp for next midnight UTC
    - `per_second_limit` integer, required — Configured per-second Navigator request limit
  - `activity` ActivityCounts, required
    - `period` '24h' | '7d' | '30d' | '90d', required
    - `scout_runs` integer, required
    - `browsing_tasks` integer, required
    - `research_tasks` integer, required
    - `navigator_calls` integer, required — Navigator (chat completions) calls in period
    - `n1_calls` integer, required — Deprecated alias of navigator_calls; prefer navigator_calls
  - `n1_rate_limits` NavigatorRateLimits, required — Rate limits for the Navigator (chat completions) endpoint.
    - `requests_today` integer, required — Navigator API requests used today (since midnight UTC)
    - `daily_limit` integer, required — Daily Navigator request limit (resets at midnight UTC)
    - `remaining_requests` integer, required — Remaining Navigator requests for today (daily_limit - requests_today)
    - `reset_at` string, required — ISO 8601 timestamp for next midnight UTC
    - `per_second_limit` integer, required — Configured per-second Navigator request limit

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/yutori/apis/fastapi.md) · [All operations](https://skmtc.dev/yutori/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yutori/fastapi/revisions/ef669f82d5bc/schema)