Skip to main content
GET
/
v1
/
usage
curl --request GET \
  --url 'https://api.yutori.com/v1/usage?period=7d' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "num_active_scouts": 5,
  "active_scout_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "d4e5f6a7-b8c9-0123-defa-234567890123",
    "e5f6a7b8-c9d0-1234-efab-345678901234"
  ],
  "rate_limits": {
    "requests_today": 1250,
    "daily_limit": 10000,
    "remaining_requests": 8750,
    "reset_at": "2026-03-04T00:00:00+00:00",
    "status": "available"
  },
  "navigator_rate_limits": {
    "requests_today": 342,
    "daily_limit": 50000,
    "remaining_requests": 49658,
    "reset_at": "2026-03-04T00:00:00+00:00",
    "per_second_limit": 20
  },
  "n1_rate_limits": {
    "requests_today": 342,
    "daily_limit": 50000,
    "remaining_requests": 49658,
    "reset_at": "2026-03-04T00:00:00+00:00",
    "per_second_limit": 20
  },
  "activity": {
    "period": "7d",
    "scout_runs": 47,
    "browsing_tasks": 12,
    "research_tasks": 8,
    "navigator_calls": 1523,
    "n1_calls": 1523
  }
}
Get usage statistics over different time periods, active scouts, and rate limits.

​
Query Parameters

​
period
string
default:"24h"
Time range for activity counts. One of 24h, 7d, 30d, or 90d.
curl --request GET \
  --url 'https://api.yutori.com/v1/usage?period=7d' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "num_active_scouts": 5,
  "active_scout_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "d4e5f6a7-b8c9-0123-defa-234567890123",
    "e5f6a7b8-c9d0-1234-efab-345678901234"
  ],
  "rate_limits": {
    "requests_today": 1250,
    "daily_limit": 10000,
    "remaining_requests": 8750,
    "reset_at": "2026-03-04T00:00:00+00:00",
    "status": "available"
  },
  "navigator_rate_limits": {
    "requests_today": 342,
    "daily_limit": 50000,
    "remaining_requests": 49658,
    "reset_at": "2026-03-04T00:00:00+00:00",
    "per_second_limit": 20
  },
  "n1_rate_limits": {
    "requests_today": 342,
    "daily_limit": 50000,
    "remaining_requests": 49658,
    "reset_at": "2026-03-04T00:00:00+00:00",
    "per_second_limit": 20
  },
  "activity": {
    "period": "7d",
    "scout_runs": 47,
    "browsing_tasks": 12,
    "research_tasks": 8,
    "navigator_calls": 1523,
    "n1_calls": 1523
  }
}
n1_rate_limits and activity.n1_calls are deprecated aliases of navigator_rate_limits and activity.navigator_calls. They mirror the canonical fields to give existing clients a migration window, and will be removed in a future release. Prefer the navigator_* names.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
period
enum<string>
default:24h
Available options:
24h,
7d,
30d,
90d

Response

Successful Response

​
num_active_scouts
integer
required
​
active_scout_ids
string<uuid>[]
required
​
rate_limits
RateLimits · object
required
​
navigator_rate_limits
NavigatorRateLimits · object
required

Rate limits for the Navigator (chat completions) endpoint.

​
activity
ActivityCounts · object
required
​
n1_rate_limits
NavigatorRateLimits · object
required
deprecated
read-only

Deprecated alias of navigator_rate_limits; prefer navigator_rate_limits