List Metric Results

curl --request GET \
  --url https://api.cartesia.ai/agents/metrics/results \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'

{
  "data": [
    {
      "id": "<string>",
      "metricId": "<string>",
      "metricName": "<string>",
      "summary": "<string>",
      "agentId": "<string>",
      "callId": "<string>",
      "deploymentId": "<string>",
      "result": "<string>",
      "status": "completed",
      "createdAt": "2023-11-07T05:31:56Z",
      "transcript": [
        {
          "role": "<string>",
          "start_timestamp": 123,
          "end_timestamp": 123,
          "text": "<string>",
          "text_chunks": [
            {
              "text": "<string>",
              "start_timestamp": 123
            }
          ],
          "end_reason": "<string>",
          "tool_calls": [
            {
              "id": "<string>",
              "name": "<string>",
              "arguments": {}
            }
          ],
          "vad_buffer_ms": 123,
          "tts_ttfb": 123,
          "log_event": {
            "event": "<string>",
            "metadata": {},
            "timestamp": 123
          },
          "log_metric": {
            "name": "<string>",
            "value": 123,
            "timestamp": 123
          }
        }
      ],
      "jsonResult": {},
      "value": "<unknown>",
      "runId": "<string>"
    }
  ],
  "has_more": true,
  "next_page": "<string>"
}

GET

agents

metrics

results

List Metric Results

curl --request GET \
  --url https://api.cartesia.ai/agents/metrics/results \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'

{
  "data": [
    {
      "id": "<string>",
      "metricId": "<string>",
      "metricName": "<string>",
      "summary": "<string>",
      "agentId": "<string>",
      "callId": "<string>",
      "deploymentId": "<string>",
      "result": "<string>",
      "status": "completed",
      "createdAt": "2023-11-07T05:31:56Z",
      "transcript": [
        {
          "role": "<string>",
          "start_timestamp": 123,
          "end_timestamp": 123,
          "text": "<string>",
          "text_chunks": [
            {
              "text": "<string>",
              "start_timestamp": 123
            }
          ],
          "end_reason": "<string>",
          "tool_calls": [
            {
              "id": "<string>",
              "name": "<string>",
              "arguments": {}
            }
          ],
          "vad_buffer_ms": 123,
          "tts_ttfb": 123,
          "log_event": {
            "event": "<string>",
            "metadata": {},
            "timestamp": 123
          },
          "log_metric": {
            "name": "<string>",
            "value": 123,
            "timestamp": 123
          }
        }
      ],
      "jsonResult": {},
      "value": "<unknown>",
      "runId": "<string>"
    }
  ],
  "has_more": true,
  "next_page": "<string>"
}

Authorizations

Authorization

string

header

required

Cartesia API key

Headers

Cartesia-Version

enum<string>

required

API version header. Must be set to the API version, e.g. '2025-04-16'.

Available options:

2024-06-10,

2024-11-13,

2025-04-16,

2026-03-01

Example:

"2025-04-16"

Query Parameters

agent_id

string | null

The ID of the agent.

deployment_id

string | null

The ID of the deployment.

metric_id

string | null

The ID of the metric.

start_date

string<date-time> | null

Filter metric results created at or after this ISO 8601 date/time (e.g. 2024-04-01T00:00:00Z).

end_date

string<date-time> | null

Filter metric results created before or at this ISO 8601 date/time (e.g. 2024-04-30T23:59:59Z).

call_id

string | null

The ID of the call.

starting_after

string | null

A cursor to use in pagination. starting_after is a metric result ID that defines your place in the list. For example, if you make a /metrics/results request and receive 100 objects, ending with metric_result_abc123, your subsequent call can include starting_after=metric_result_abc123 to fetch the next page of the list.

ending_before

string | null

A cursor to use in pagination. ending_before is a metric result ID that defines your place in the list. For example, if you make a /metrics/results request and receive 100 objects, starting with metric_result_abc123, your subsequent call can include ending_before=metric_result_abc123 to fetch the previous page of the list.

limit

integer | null

The number of metric results to return per page, ranging between 1 and 100.

Response

200 - application/json

data

MetricResult · object[]

required

List of metric results.

Show child attributes

has_more

boolean

required

Whether there are more metric results to fetch (using starting_after=id, where id is the ID of the last MetricResult in the current response).

next_page

string | null

The cursor for the next page of results.

⌘I