Analytics

Get user activity grouped by endpoint

Changed on

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

Request

  • Base URL: https://openrouter.ai/api/v1
  • URL: https://openrouter.ai/api/v1/activity
  • Auth: HTTP bearer

Query parameters

datestring

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

Example:2025-08-24
api_key_hashstring

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

Example:abc123def456...
user_idstring

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

Example:user_abc123
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
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

Response

Returns user activity data grouped by endpoint

Example response

{
  "data": [
    {
      "byok_usage_inference": 0.012,
      "cached_tokens": 10,
      "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
    }
  ]
}

Changes

  • ca5314e7fa24Revision changes
    • info

      added the required property // to the response with the status

  • b0afa90ea2e8Revision changes
    • info

      added the new optional query request parameter group_by

    • info

      added the new optional query request parameter workspace_id

    • info

      added the optional property // to the response with the status