Skip to main content

Overview

Analytics and usage endpoints

Available Operations

GetUserActivity

Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. 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)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

ParameterTypeRequiredDescriptionExample
ctxcontext.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
opts[]operations.Option:heavy_minus_sign:The options for this request.

Response

*components.ActivityResponse, error

Errors

Error TypeStatus CodeContent Type
sdkerrors.BadRequestResponseError400application/json
sdkerrors.UnauthorizedResponseError401application/json
sdkerrors.ForbiddenResponseError403application/json
sdkerrors.NotFoundResponseError404application/json
sdkerrors.InternalServerResponseError500application/json
sdkerrors.APIError4XX, 5XX*/*