Analytics

Overview

Analytics and usage endpoints

Available Operations

GetUserActivity - Get user activity grouped by endpoint

GetUserActivity

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.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.Analytics.GetUserActivity(ctx, nil, nil, nil, nil, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`date`	`*string`	:heavy_minus_sign:	Filter by a single UTC date in the last 30 days (YYYY-MM-DD format).	2025-08-24
`apiKeyHash`	`*string`	:heavy_minus_sign:	Filter by API key hash (SHA-256 hex string, as returned by the keys API).	abc123def456…
`userID`	`*string`	:heavy_minus_sign:	Filter by org member user ID. Only applicable for organization accounts.	user_abc123
`groupBy`	*operations.GroupBy	:heavy_minus_sign:	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
`workspaceID`	`*string`	:heavy_minus_sign:	Filter by workspace ID (UUID). Returns only activity attributed to that workspace. The workspace must belong to the authenticated account.	550e8400-e29b-41d4-a716-446655440000
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.ActivityResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.APIError	4XX, 5XX	/

TypeScript SDK

Python SDK

Go SDK

DevTools

Overview

Available Operations

GetUserActivity

Example Usage

Parameters

Response

Errors

​Overview

​Available Operations

​GetUserActivity

​Example Usage

​Parameters

​Response

​Errors

Overview

Available Operations

GetUserActivity

Example Usage

Parameters

Response

Errors