get aggregated session analytics

curl --request GET \
  --url https://api.anam.ai/v1/sessions/analytics \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.anam.ai/v1/sessions/analytics"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anam.ai/v1/sessions/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anam.ai/v1/sessions/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anam.ai/v1/sessions/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.anam.ai/v1/sessions/analytics")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anam.ai/v1/sessions/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "from": "2026-04-19T09:00:00.000Z",
  "to": "2026-04-20T09:00:00.000Z",
  "filters": {
    "personaId": null,
    "apiKeyId": null,
    "clientLabel": null,
    "sessionType": null
  },
  "sessionCount": 128,
  "sessionsWithReports": 121,
  "truncated": false,
  "turnCount": 1874,
  "latencies": {
    "transcriptionLatencySeconds": {
      "count": 1702,
      "avg": 0.34,
      "p50": 0.29,
      "p90": 0.52,
      "p95": 0.61,
      "p99": 0.94,
      "max": 1.87
    },
    "llmTimeToFirstOutputSeconds": {
      "count": 1698,
      "avg": 0.61,
      "p50": 0.54,
      "p90": 0.92,
      "p95": 1.18,
      "p99": 2.04,
      "max": 4.31
    },
    "llmGenerationDurationSeconds": {
      "count": 1698,
      "avg": 1.42,
      "p50": 1.31,
      "p90": 2.12,
      "p95": 2.54,
      "p99": 3.87,
      "max": 7.02
    },
    "ttsGenerationDurationSeconds": {
      "count": 1671,
      "avg": 1.18,
      "p50": 1.09,
      "p90": 1.74,
      "p95": 2.02,
      "p99": 2.98,
      "max": 5.44
    },
    "ttsTimeToFirstAudioSeconds": {
      "count": 1671,
      "avg": 0.41,
      "p50": 0.37,
      "p90": 0.62,
      "p95": 0.74,
      "p99": 1.12,
      "max": 2.36
    },
    "firstAudioLatencySeconds": {
      "count": 1698,
      "avg": 1.31,
      "p50": 1.18,
      "p90": 1.86,
      "p95": 2.21,
      "p99": 3.42,
      "max": 6.75
    },
    "speakingDurationSeconds": {
      "count": 1698,
      "avg": 7.85,
      "p50": 6.92,
      "p90": 13.41,
      "p95": 16.08,
      "p99": 22.6,
      "max": 41.19
    },
    "userSpeechDurationSeconds": {
      "count": 1702,
      "avg": 3.62,
      "p50": 3.11,
      "p90": 6.4,
      "p95": 7.83,
      "p99": 11.9,
      "max": 19.75
    }
  },
  "counts": {
    "completedTurns": 1512,
    "interruptedTurns": 186,
    "interruptedBeforeAudioTurns": 22,
    "totalErrors": 4,
    "totalWarnings": 19,
    "sessionsWithErrors": 3,
    "sessionsWithWarnings": 11,
    "toolCalls": {
      "total": 96,
      "succeeded": 91,
      "failed": 5,
      "byName": {
        "lookup_order": 96
      }
    }
  },
  "rates": {
    "interruptionRate": 0.1095,
    "interruptedBeforeAudioRate": 0.013,
    "errorSessionRate": 0.0248,
    "warningSessionRate": 0.0909,
    "toolCallFailureRate": 0.0521
  },
  "slowestTurns": [
    {
      "sessionId": "00000000-0000-0000-0000-000000000000",
      "correlationId": "corr-1042",
      "metric": "firstAudioLatencySeconds",
      "valueSeconds": 6.75,
      "sessionStartTime": "2026-04-20T08:41:12.000Z",
      "personaId": null,
      "clientLabel": "js-sdk-api-key"
    },
    {
      "sessionId": "00000000-0000-0000-0000-000000000000",
      "correlationId": "corr-0311",
      "metric": "llmTimeToFirstOutputSeconds",
      "valueSeconds": 4.31,
      "sessionStartTime": "2026-04-20T07:02:44.000Z",
      "personaId": null,
      "clientLabel": "js-sdk-api-key"
    }
  ]
}

get aggregated session analytics

Returns aggregated latency analytics across sessions — percentile distributions (p50/p90/p95/p99/max/avg) for each stage of the transcription → LLM → TTS → first-audio path, interruption and error rates, tool call outcomes, and a sample of the slowest turns. Only sessions where Anam runs the conversational pipeline (turnkey, custom LLM and ElevenLabs agent sessions) produce analytics reports; LiveKit and audio-passthrough sessions count toward sessionCount but never carry analytics. Defaults to the last 24 hours; the maximum range is 31 days. Reports are aggregated from the 1000 most recent report-capable sessions matching the filters — session types that never produce reports don’t consume that window — and the truncated field reports when more report-capable sessions matched. Narrow the time range or filters to analyse busier periods exhaustively.

GET

sessions

analytics

curl --request GET \
  --url https://api.anam.ai/v1/sessions/analytics \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.anam.ai/v1/sessions/analytics"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anam.ai/v1/sessions/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anam.ai/v1/sessions/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anam.ai/v1/sessions/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.anam.ai/v1/sessions/analytics")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anam.ai/v1/sessions/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "from": "2026-04-19T09:00:00.000Z",
  "to": "2026-04-20T09:00:00.000Z",
  "filters": {
    "personaId": null,
    "apiKeyId": null,
    "clientLabel": null,
    "sessionType": null
  },
  "sessionCount": 128,
  "sessionsWithReports": 121,
  "truncated": false,
  "turnCount": 1874,
  "latencies": {
    "transcriptionLatencySeconds": {
      "count": 1702,
      "avg": 0.34,
      "p50": 0.29,
      "p90": 0.52,
      "p95": 0.61,
      "p99": 0.94,
      "max": 1.87
    },
    "llmTimeToFirstOutputSeconds": {
      "count": 1698,
      "avg": 0.61,
      "p50": 0.54,
      "p90": 0.92,
      "p95": 1.18,
      "p99": 2.04,
      "max": 4.31
    },
    "llmGenerationDurationSeconds": {
      "count": 1698,
      "avg": 1.42,
      "p50": 1.31,
      "p90": 2.12,
      "p95": 2.54,
      "p99": 3.87,
      "max": 7.02
    },
    "ttsGenerationDurationSeconds": {
      "count": 1671,
      "avg": 1.18,
      "p50": 1.09,
      "p90": 1.74,
      "p95": 2.02,
      "p99": 2.98,
      "max": 5.44
    },
    "ttsTimeToFirstAudioSeconds": {
      "count": 1671,
      "avg": 0.41,
      "p50": 0.37,
      "p90": 0.62,
      "p95": 0.74,
      "p99": 1.12,
      "max": 2.36
    },
    "firstAudioLatencySeconds": {
      "count": 1698,
      "avg": 1.31,
      "p50": 1.18,
      "p90": 1.86,
      "p95": 2.21,
      "p99": 3.42,
      "max": 6.75
    },
    "speakingDurationSeconds": {
      "count": 1698,
      "avg": 7.85,
      "p50": 6.92,
      "p90": 13.41,
      "p95": 16.08,
      "p99": 22.6,
      "max": 41.19
    },
    "userSpeechDurationSeconds": {
      "count": 1702,
      "avg": 3.62,
      "p50": 3.11,
      "p90": 6.4,
      "p95": 7.83,
      "p99": 11.9,
      "max": 19.75
    }
  },
  "counts": {
    "completedTurns": 1512,
    "interruptedTurns": 186,
    "interruptedBeforeAudioTurns": 22,
    "totalErrors": 4,
    "totalWarnings": 19,
    "sessionsWithErrors": 3,
    "sessionsWithWarnings": 11,
    "toolCalls": {
      "total": 96,
      "succeeded": 91,
      "failed": 5,
      "byName": {
        "lookup_order": 96
      }
    }
  },
  "rates": {
    "interruptionRate": 0.1095,
    "interruptedBeforeAudioRate": 0.013,
    "errorSessionRate": 0.0248,
    "warningSessionRate": 0.0909,
    "toolCallFailureRate": 0.0521
  },
  "slowestTurns": [
    {
      "sessionId": "00000000-0000-0000-0000-000000000000",
      "correlationId": "corr-1042",
      "metric": "firstAudioLatencySeconds",
      "valueSeconds": 6.75,
      "sessionStartTime": "2026-04-20T08:41:12.000Z",
      "personaId": null,
      "clientLabel": "js-sdk-api-key"
    },
    {
      "sessionId": "00000000-0000-0000-0000-000000000000",
      "correlationId": "corr-0311",
      "metric": "llmTimeToFirstOutputSeconds",
      "valueSeconds": 4.31,
      "sessionStartTime": "2026-04-20T07:02:44.000Z",
      "personaId": null,
      "clientLabel": "js-sdk-api-key"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

from

string<date-time>

Start of the time range (ISO 8601). Defaults to 24 hours before to.

string<date-time>

End of the time range (ISO 8601). Defaults to now.

personaId

string<uuid>

Only include sessions for this persona.

apiKeyId

string<uuid>

Only include sessions minted by this API key.

clientLabel

string

Only include sessions whose client label matches exactly.

sessionType

enum<string>

Only include sessions of this type.

Available options:

turnkey,

custom_llm_server,

custom_llm_client,

livekit,

elevenlabs_agent

organizationId

string

Aggregate sessions of another organization. Restricted to Anam-internal admin API keys; other keys receive 403.

Response

Successfully computed aggregate analytics

from

string<date-time>

filters

object

Echo of the applied filters.

Show child attributes

sessionCount

integer

Total sessions matching the filters in the range, whether or not they produced an analytics report.

sessionsWithReports

integer

Sessions whose analytics report was aggregated. Reports are read from the 1000 most recent report-capable matching sessions; session types that never produce reports don't consume that window.

truncated

boolean

True when more than 1000 report-capable sessions matched; only reports among the most recent 1000 of them were aggregated.

turnCount

integer

latencies

object

Percentile distributions per latency stage, computed across all turns.

Show child attributes

counts

object

Show child attributes

rates

object

Show child attributes

slowestTurns

object[]

The slowest turns per headline latency metric, for jumping straight to problem sessions.

Show child attributes

Last modified on July 24, 2026

get session concurrency status get session

⌘I

Use the API

Sessions

Meetings

Personas

Avatars

Voices

LLMs

Knowledge

Tools

Share Links

Engine

get aggregated session analytics

Authorizations

Query Parameters

Response