List tool event logs

get

https://api.revenium.ai/profitstream/v2/api/sources/metrics/tool/events

        Returns a paginated list of tool event line items for the specified team.
        Tool events represent tool/function calls that have been processed through the metering pipeline.

        Supports filtering by date range, tool ID, tool name, tool type, operation,
        transaction ID, product, and charge amount.

        Results are sorted by timestamp descending by default.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

For UUID terms, searches transaction ID by exact match first; when no ID matches, falls back to partial match across tool name, tool ID and resource/operation.

startDate

string

length between 0 and 255

Filter start date/time in ISO 8601 format.

endDate

string

length between 0 and 255

Filter end date/time in ISO 8601 format.

toolId

string

length between 1 and 255

Filter by tool ID (the tool's external toolId, not the database ID).

toolName

string

length between 1 and 255

Filter by tool name.

toolType

string

enum

Filter by tool type.

Allowed:

operation

string

length between 1 and 255

Filter by operation (parsed from the resource field).

transactionId

string

length between 1 and 255

Exact transaction ID match.

productId

string

length between 1 and 255

Filter by product ID.

chargeMin

string

0 to 999999.99

Minimum charge amount ($).

chargeMax

string

0 to 999999.99

Maximum charge amount ($).

teamId

string

required

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

page

integer

≥ 0

Defaults to 0

Zero-based page index (0..N)

size

integer

≥ 1

Defaults to 10

The size of the page to be returned

sort

array of strings

Defaults to timestamp,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

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/hal+json

*/*

200Returns a paginated list of tool event line items.

400Invalid request parameters or validation failed

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Team not found

409Conflict

422Unprocessable Entity - Validation failed (e.g. constraint violations on filter parameters)

429Too Many Requests

500Internal server error