API Reference
Log In
API Reference

List AI completion metrics for a team

get
https://api.revenium.ai/profitstream/v2/api/sources/metrics/ai/completions

Retrieve a paginated list of AI completion metrics for a specified team.

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

Searches trace ID and transaction ID by exact match first; when no ID matches, falls back to partial match across agent, model, provider, error reason and subscriber email.

string

Filter start date/time in ISO 8601 format.

string

Filter end date/time in ISO 8601 format.

int64
0 to 60000

Minimum time to first token (in milliseconds).

int64
0 to 60000

Maximum time to first token (in milliseconds).

int64
0 to 300000

Minimum request duration (in milliseconds).

int64
0 to 300000

Maximum request duration (in milliseconds).

int64
0 to 10000

Minimum mediation latency (in milliseconds).

int64
0 to 10000

Maximum mediation latency (in milliseconds).

int64
0 to 10000000

Minimum input tokens.

int64
0 to 10000000

Maximum input tokens.

int64
0 to 10000000

Minimum output tokens.

int64
0 to 10000000

Maximum output tokens.

int64
0 to 5000000

Minimum reasoning tokens.

int64
0 to 5000000

Maximum reasoning tokens.

int64
0 to 5000000

Minimum cached tokens.

int64
0 to 5000000

Maximum cached tokens.

int64
0 to 20000000

Minimum total tokens.

int64
0 to 20000000

Maximum total tokens.

number
0 to 99999.99

Minimum input cost ($).

number
0 to 99999.99

Maximum input cost ($).

number
0 to 99999.99

Minimum output cost ($).

number
0 to 99999.99

Maximum output cost ($).

number
0 to 999999.99

Minimum total cost ($).

number
0 to 999999.99

Maximum total cost ($).

string
length between 1 and 255

Exact transaction ID match.

transactionIds
array of strings
length between 1 and 100

Any of these exact transaction IDs, at most 100. The Transaction Log's ClickHouse search sends the page's ids here so the rows render from Postgres.

transactionIds

Any of these exact transaction IDs, at most 100. The Transaction Log's ClickHouse search sends the page's ids here so the rows render from Postgres.

string
length between 1 and 255

Exact trace ID match.

string
length between 1 and 255

Filter by trace type. Use 'unknown' for metrics without traceType.

string
length between 1 and 255

Filter by trace name.

string
length between 1 and 255

Filter by organization name.

string

Filter by subscriber email.

string
length between 1 and 255

Filter by subscriber ID.

string
length between 1 and 255

Filter by subscription ID.

string
length between 1 and 255

Filter by product ID.

string
length between 1 and 255

Filter by agent name.

string
length between 1 and 255

Filter by AI provider.

string
length between 1 and 255

Filter by AI model.

string
length between 1 and 255

Filter by model source.

string
length between 1 and 255

Filter by task type.

double
0 to 2

Minimum temperature value.

double
0 to 2

Maximum temperature value.

string
enum

Filter by stop reason.

string
length between 1 and 255

Filter by error reason.

number
0 to 1

Minimum response quality score.

number
0 to 1

Maximum response quality score.

string
length between 1 and 255

Filter by credential name.

string
length between 1 and 255

Filter by system fingerprint.

string
length between 1 and 255

Filter by environment (exact match).

boolean

Whether to include coding assistant metrics (e.g. Claude Code, Gemini CLI). When true, usage from all coding assistants is included, regardless of your team's pricing settings and of includeCodingAssistantProviders. When false (default), only coding assistants your team pays for per API call are included, and the rest are treated as seat subscriptions and left out.

includeCodingAssistantProviders
array of strings

Coding assistants you pay for per API call, not by seat. Their usage counts as spend. Others are treated as seat subscriptions and left out of cost totals. Accepted values: ClaudeCode, ClaudeCowork, CursorIde, GeminiCli, CodexCli, GithubCopilot. The values are validated, but the list does not change the results: the assistants that count as spend come from your team's coding assistant pricing settings. Set includeCodingAssistants to true to include all coding assistants regardless of those settings.

includeCodingAssistantProviders
string
required

ID of the team that owns this data.

integer
≥ 0
Defaults to 0

Zero-based page index (0..N)

integer
≥ 1
Defaults to 10

The size of the page to be returned

sort
array of strings
Defaults to requestTime,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

Updated 5 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/hal+json
*/*

Updated 5 months ago

Did this page help you?