API Reference
Log In
API Reference

Get AI Traces

Get aggregated AI trace metrics grouped by traceId. Each trace represents multiple AI completion transactions grouped together by a common trace identifier. Traces can be filtered by date range, trace properties, cost, and duration.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
length between 1 and 255

Exact trace ID match. Use this to retrieve a specific trace.

string
length between 1 and 255

Filter by trace type category (exact match).

string
length between 1 and 255

Filter by trace name (exact match).

string
0 to 999999.99

Minimum total cost filter. Returns traces with totalCost >= this value.

string
0 to 999999.99

Maximum total cost filter. Returns traces with totalCost <= this value.

int64
0 to 300000

Minimum trace duration in milliseconds. Returns traces with traceDuration >= this value.

int64
0 to 300000

Maximum trace duration in milliseconds. Returns traces with traceDuration <= this value.

string
required

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

string

Time period for analysis (e.g., THIRTY_DAYS, SEVEN_DAYS). If not provided, returns all traces without date filtering.

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 startTime,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
application/hal+json
*/*