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

# Get Usage

`GET /v1/usage`

## Request

- Base URL: `https://api.yutori.com`
- URL: `https://api.yutori.com/v1/usage`
- Auth: API key in header `x-api-key`

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/yutori-api.md) - [All operations](https://skmtc.dev/yutori/apis/yutori-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yutori/apis/yutori-api/revisions/ef669f82d5bc?raw)