Skip to main content
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",
      "metricDisplayName": "<string>",
      "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": {},
              "result": "<string>"
            }
          ],
          "vad_buffer_ms": 123,
          "stt_ttfb": 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 (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

​
Cartesia-Version
enum<string>
required

API version header.

Available options:
2024-06-10,
2024-11-13,
2025-04-16,
2026-03-01
Example:

"2026-03-01"

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 RFC 3339 datetime.

Example:

"2024-04-01T00:00:00Z"

​
end_date
string<date-time> | null

Filter metric results created before or at this RFC 3339 datetime.

Example:

"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.

​
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.