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

# List Metric Results

`GET /agents/metrics/results`

## Request

- Base URL: `https://api.cartesia.ai`
- URL: `https://api.cartesia.ai/agents/metrics/results`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cartesia/apis/cartesia-api/docs/agents/metrics/results/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/cartesia/apis/cartesia-api.md) - [All operations](https://skmtc.dev/cartesia/apis/cartesia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cartesia/apis/cartesia-api/revisions/8910812440d3?raw)