Usage, activity & rankings

BharatRouter exposes your org's consumption two ways: lightweight usage counters and a richer activity feed with per-request drill-down. There's also a public rankings endpoint showing the most-used models platform-wide. All org date math is in IST (Asia/Kolkata).

Usage

Endpoint	Returns
GET /me/usage	Requests and tokens per key, today and over the last 30 days, plus org totals.
GET /me/usage/daily	A day × model series for the last 30 IST days — powers the dashboard chart.

Activity

GET /me/activity returns spend and volume aggregates over a date range, with filters. Cost comes from what was actually debited (trial, BYOK and failed requests count as ₹0).

Query	Meaning
from, to	YYYY-MM-DD (IST). Defaults to the last 30 days; max span 366 days.
model, key_id	Optional filters.

The response carries a day × model days series, top_models and top_keys, a per-provider cost split for each model (model_providers, showing realized cost across fallbacks), org totals (requests, tokens, cost, errors, BYOK requests), and the distinct model/key lists for filter dropdowns.

Per-request drill-down

GET /me/activity/events lists individual requests, newest first, with keyset pagination. Each row has the model, provider that served it, status, latency, tokens, cost, and the key name. Page with before=<id> and limit (≤200); the response returns next_before for the next page.

GET /me/activity/events?from=2026-06-01&to=2026-06-13&limit=50
→ { "events": [ { "at": "...", "model": "krutrim-2", "provider": "krutrim",
                  "status": 200, "latency_ms": 740, "tokens": 312,
                  "cost_inr": 0.0061, "key_name": "prod" }, ... ],
    "next_before": 80421 }

Rankings (public, no auth)

GET /v1/rankings returns the most-used catalog models by token volume over 7-day and 30-day windows — anonymous and platform-wide, never per-customer. BYOK-only model ids are excluded; the result is cached for a few minutes.

curl -s https://api.bharatrouter.com/v1/rankings | jq '.windows["7d"][0]'
→ { "model": "krutrim-2", "requests": 18342, "tokens": 9120553 }