Skip to content

List analyzed tool calls

GET
/v2/token-analysis
curl --request GET \
--url 'https://api.runta.me/v2/token-analysis?page_size=50' \
--header 'Authorization: Bearer <token>'

Findings are computed once, when the event is ingested, and never recomputed. The summary covers everything the filter selects rather than the page returned.

runtime_id
string
page_token
string
page_size
integer format: uint32
default: 50 >= 1 <= 100

Response envelope.

Media typeapplication/json
object
data
required
object
calls
required
Array<object>
object
id
required
string
event_id
required
string
runtime_id
required
string
provider
required
string
nullable
tool_name
required
string
nullable
tool_call_id
required
string
nullable
observed_at_unix_millis
required
integer format: int64
input_chars
required
integer format: int64
output_chars
required
integer format: int64
total_chars
required
integer format: int64
estimated_input_tokens
required
integer format: int64
estimated_output_tokens
required
integer format: int64
estimated_total_tokens
required
integer format: int64
estimated_savings_tokens
required
integer format: int64
truncated
required
boolean
parse_error
required
string
nullable
analysis_issues
required
Array<object>
object
kind
required
string
Allowed values: truncated_capture parse_error
severity
required
string
Allowed values: info warning danger
confidence
required
string
Allowed values: low medium high
title
required
string
detail
required
string
findings
required
Array<object>
object
kind
required
string
Allowed values: large_output repeated_lines repeated_keys repeated_paths repeated_call
severity
required
string
Allowed values: info warning danger
confidence
required
string
Allowed values: low medium high
title
required
string
detail
required
string
estimated_savings_tokens
required
integer format: int64
input_preview
required
string
output_preview
required
string
analyzer_version
required

Which rule set produced this row. Findings are never recomputed.

integer format: int32
summary
required

Totals over everything the filter selects, not merely the page returned.

object
total_calls
required
integer format: int64
calls_with_findings
required
integer format: int64
calls_with_analysis_issues
required
integer format: int64
estimated_tokens
required
integer format: int64
estimated_savings_tokens
required
integer format: int64
truncated_calls
required
integer format: int64
next_page_token
required
string
nullable
Example
{
"data": {
"calls": [
{
"analysis_issues": [
{
"kind": "truncated_capture",
"severity": "info",
"confidence": "low"
}
],
"findings": [
{
"kind": "large_output",
"severity": "info",
"confidence": "low"
}
]
}
]
}
}

Missing, malformed, or rejected bearer token

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

The bearer token is not allowed to perform this action

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

The requested resource was not found

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

The request conflicts with current resource state

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

Validation or application error

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

Rate limit exceeded

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

Operation is not implemented

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

Upstream service is unavailable

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

Upstream request timed out

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}

Error response

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented
message
required
string
request_id
required

UUID v7 correlation ID shared with the X-Request-Id response header.

string
Example
{
"error": {
"code": "already_exists"
}
}