---
title: "List Metric Results"
method: GET
path: "/agents/metrics/results"
tags: ["Agents"]
---

# List Metric Results

`GET /agents/metrics/results`

## Query parameters

- `agent_id` string, nullable
- `deployment_id` string, nullable
- `metric_id` string, nullable
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `call_id` string, nullable
- `starting_after` string, nullable
- `ending_before` string, nullable
- `limit` integer, nullable

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- ListMetricResultsResponse
  - `data` MetricResult[], required — List of metric results.
    - `id` string, required — The unique identifier for the metric result.
    - `metricId` string, required — The identifier of the metric being measured.
    - `metricName` string, required — The name of the metric being measured.
    - `metricDisplayName` string, nullable — The display name of the metric, if available.
    - `summary` string, required — A summary of the transcript of the call.
    - `transcript` AgentTranscript[], nullable — The transcript of the call.
      - `role` string, required — The role of the participant in the conversation. Roles are `user`, `assistant`, or `system`. `assistant` is the agent. `system` is used to indicate logs during the conversation such as `log_event` or `log_metric`.
      - `text` string, nullable — The text content of the transcript. This is the text that was spoken by the user or the agent.
      - `start_timestamp` number, float, required — The start timestamp in seconds relative to the start of the call.
      - `end_timestamp` number, float, required — The end timestamp in seconds relative to the start of the call.
      - `tool_calls` ToolCall[], nullable — The tool calls made during the turn.
        - `id` string — The unique identifier for the tool call.
        - `name` string, required — The name of the tool that was called.
        - `arguments` object, required — The arguments passed to the tool.
        - `result` string — The result returned by the tool.
      - `stt_ttfb` number, float, nullable — The time to first byte in seconds for speech-to-text.
      - `tts_ttfb` number, float, nullable — The time to first byte in seconds from the agent for text-to-speech.
      - `log_event` LogEvent
        - `event` string, required — The event name.
        - `metadata` object, required — Additional metadata associated with the event.
        - `timestamp` number, double, required — The timestamp when the event was received relative to the start of the call.
      - `log_metric` LogMetric
        - `name` string, required — The name of the metric.
        - `value` union, required — The value of the metric.
          - number, double
          - string
          - boolean
        - `timestamp` number, double, required — The timestamp when the metric was received relative to the start of the call.
    - `agentId` string, required — The identifier of the agent associated with the metric result.
    - `callId` string, required — The identifier of the call associated with the metric result.
    - `deploymentId` string, required — The identifier of the deployment associated with the metric result.
    - `result` string, required — The raw result of the metric in a string format.
    - `jsonResult` object, nullable — The structured JSON result of the metric.
    - `value` unknown
    - `status` 'completed' | 'failed', required — The status of an agent metric result. `failed` indicates that the metric result was not computed or parsed properly.
    - `runId` string, nullable — The identifier of the run associated with the metric result, if applicable.
    - `createdAt` string, date-time, required — The UTC timestamp when the metric result was created.
  - `has_more` boolean, required — Whether there are more metric results to fetch.
  - `next_page` string, nullable — An ID that can be passed as `starting_after` or `ending_before` to get the next page of metric results.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)