Usage Stats

Usage Stats

Retrieve usage metrics for your account or specific API keys.

Endpoint

GET /v1/usage

Parameters

Parameter	Type	Description
period	string	today, week, month, or ISO date range
key_id	string	Filter by specific API key (optional)
group_by	string	day, hour, target (optional)

Response

{
  "period": "2026-05-01/2026-05-30",
  "total_requests": 1250000,
  "total_bytes": 53687091200,
  "total_bytes_human": "50 GB",
  "unique_targets": 342,
  "heal_events": 1893,
  "avg_latency_ms": 187,
  "daily": [
    { "date": "2026-05-30", "requests": 45000, "bytes": 1932735283 }
  ]
}