API Reference
Log In
API Reference

List API Key Analytics

Retrieves API key analytics data grouped by API key for the authenticated user's organization.

Returns paginated API key-level costs with detailed usage metrics. One row per API key,
where a key is identified by provider and key id together — the same key id under two
providers is two keys and returns two rows.

sort: totalCost (default, descending), provider, apiKeyId, apiKeyName,
workspaceId, workspaceName, partialKeyHint, status, percentage, requestCount,
totalTokens, uncachedInputTokens, cachedInputTokens, cacheWriteTokens,
outputTokens, imageCount, costPer1M, creditsApplied. These are the aggregate
names, not the response field names, and an unknown key fails the request with 400.

minCost / maxCost: applied to a key's combined cost across all of its usage
types, which is the figure each row reports.

All costs are in USD. Token counts include all token types (input, output, cache).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Unique identifier of the team (organization). Format: Revenium hashid (URL-safe encoded string).

string
enum
required

Time period for analytics

Allowed:
string

Filter start date/time in ISO 8601 format.

string

Filter end date/time in ISO 8601 format.

string
enum

Filter results by AI provider. Omit to include all providers.

Allowed:
string
enum

Filter by usage type. Omit to include all types.

Allowed:
string

Narrow results to a single API key id, within the caller's organization. A value that matches nothing returns an empty result, never the organization total.

number
≥ 0

Filter by a starting cost (inclusive).

number
≥ 0

Filter by an ending cost (inclusive).

string

Search query to filter API keys by name

integer
≥ 0
Defaults to 0

Zero-based page index (0..N)

integer
≥ 1
Defaults to 20

The size of the page to be returned

sort
array of strings
Defaults to totalCost,DESC

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

sort
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*