Sign in

v126

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-04957391.2 MB
Analytics

Get user activity grouped by endpoint

Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass workspace_id to scope the response to a single workspace. Pass group_by=workspace to split each row per workspace and include workspace_id on every item; by default rows are aggregated across workspaces and workspace_id is not returned. Activity recorded before workspace resolution existed is permanently attributed to the account default workspace (no backfill is possible). Management key required.

get/activity

Query parameters

datestring

Filter by a single UTC date in the last 30 days (YYYY-MM-DD format).

Example:2025-08-24

Filter by a single UTC date in the last 30 days (YYYY-MM-DD format).

api_key_hashstring

Filter by API key hash (SHA-256 hex string, as returned by the keys API).

Example:abc123def456...

Filter by API key hash (SHA-256 hex string, as returned by the keys API).

user_idstring

Filter by org member user ID. Only applicable for organization accounts.

Example:user_abc123

Filter by org member user ID. Only applicable for organization accounts.

group_by'workspace'

Set to 'workspace' to split each row per workspace and include workspace_id on every item. Omitted by default, in which case rows are aggregated across workspaces (by date, model, and endpoint) and workspace_id is not returned — preserving the historical response shape.

Example:workspace

Set to 'workspace' to split each row per workspace and include workspace_id on every item. Omitted by default, in which case rows are aggregated across workspaces (by date, model, and endpoint) and workspace_id is not returned — preserving the historical response shape.

workspace_idstring

Filter by workspace ID (UUID). Returns only activity attributed to that workspace. The workspace must belong to the authenticated account.

Example:550e8400-e29b-41d4-a716-446655440000

Filter by workspace ID (UUID). Returns only activity attributed to that workspace. The workspace must belong to the authenticated account.

Response

Returns user activity data grouped by endpoint

Example response

{
  "data": [
    {
      "byok_usage_inference": 0.012,
      "completion_tokens": 125,
      "date": "2025-08-24",
      "endpoint_id": "550e8400-e29b-41d4-a716-446655440000",
      "model": "openai/gpt-4.1",
      "model_permaslug": "openai/gpt-4.1-2025-04-14",
      "prompt_tokens": 50,
      "provider_name": "OpenAI",
      "reasoning_tokens": 25,
      "requests": 5,
      "usage": 0.015
    }
  ]
}