Skip to main content
GET
List conversation metrics

Authorizations

X-API-Key
string
header
required

API key for authentication.

Path Parameters

conversation_id
string
required

Unique conversation identifier

Required string length: 22 - 26

Query Parameters

filter
string

Filter expression syntax.

Values may be unquoted or double-quoted. Values containing spaces must be quoted.

Supported fields:

  • metric_name (string): Filter by metric name (e.g., metric_name=latency)
  • status (string): Filter by status (e.g., status=COMPLETED)
  • output_type (string): Filter by type (e.g., output_type=float)

Examples:

  • filter=status=COMPLETED
  • filter=metric_name=latency AND status=COMPLETED
  • filter=output_type=float
page_size
integer
default:50

Maximum number of metrics to return (1-1000)

Required range: 1 <= x <= 1000
page_token
string

Pagination token from previous response (for fetching next page)

view
enum<string>
default:FULL

Response detail level. FULL preserves the historical response including structured result and runtime_metadata; BASIC omits those heavy fields while retaining value, status, explanation, and bounded subvalues.

Available options:
BASIC,
FULL
include_superseded
boolean
default:false

Include outputs that a later re-score of the same metric has superseded.

When false (default) each metric contributes only its most recent output. When true every output is returned, so one metric may appear multiple times; recency is determined by creation time, with the metric_output_id ULID breaking ties, and the response order still follows order_by.

order_by
string
default:metric_name

Field to order results by.

Supported fields:

  • metric_name (default): Sort by metric name alphabetically
  • create_time: Sort by creation time
  • start_time: Sort by computation start time
  • end_time: Sort by computation end time
  • value: Sort by metric value (float types only)

Prefix with - for descending order (e.g., -create_time)

Response

List of metrics

metrics
object[]
required

List of simplified metric outputs

next_page_token
string | null

Pagination token for next page (null if no more results)

Example:

"eyJvZmZzZXQiOiAxMDB9"