Skip to main content
GET
/
voice_sdk_call_reports
/
{call_id}
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const voiceSDKCallReports = await client.voiceSDKCallReports.retrieve(
  '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
);

console.log(voiceSDKCallReports);
[
  {
    "call_id": "6d6fb6f1-2b82-4d75-9eb5-3c8e995f1ed1",
    "voice_sdk_id": "VSDK1Cu-AUDpaCkbs5LKcSUK9jLZFcgqLdg",
    "voice_sdk_session_id": "0a52a677-9784-4841-ad31-9596c6e5b970",
    "voice_sdk_id_decoded": {
      "region": "us-central-1"
    },
    "user_agent": "TelnyxRTC/2.24.0 (iOS 17.5)",
    "version": "2.24.0",
    "telnyx_session_id": "9a0f6b0e-fb1f-44c9-9b53-7f81442b4c5f",
    "telnyx_leg_id": "2d0dd8f1-7d90-4f1f-b8e8-67f9fbdfe2bd",
    "stored_at": "2026-05-06T20:00:05Z",
    "summary": {
      "callId": "6d6fb6f1-2b82-4d75-9eb5-3c8e995f1ed1"
    },
    "stats": [
      {
        "intervalStartUtc": "2026-05-06T20:00:00Z",
        "intervalEndUtc": "2026-05-06T20:00:05Z",
        "audio": {
          "inbound": {
            "packetsReceived": 1840,
            "packetsLost": 0,
            "jitterAvg": 0.003
          },
          "outbound": {
            "packetsSent": 1837,
            "bytesSent": 293920
          }
        },
        "connection": {
          "roundTripTimeAvg": 0.041,
          "bytesSent": 293920,
          "bytesReceived": 312880
        },
        "ice": {
          "state": "succeeded",
          "nominated": true,
          "local": {
            "candidateType": "host",
            "protocol": "udp"
          },
          "remote": {
            "candidateType": "srflx",
            "protocol": "udp"
          }
        },
        "transport": {
          "iceState": "connected",
          "dtlsState": "connected",
          "srtpCipher": "AES_CM_128_HMAC_SHA1_80"
        }
      }
    ],
    "logs": [
      {
        "timestamp": "2026-05-06T20:00:00Z",
        "level": "debug",
        "message": "rtcpeer candidate selected",
        "context": {
          "candidateType": "host",
          "protocol": "udp"
        }
      }
    ],
    "flushReason": {
      "type": "call-end"
    },
    "segment": 0,
    "user_id": "3307ca65-df56-4f15-8ba7-589d584d215b",
    "organization_id": "06a3dfbd-4988-4fb1-8d28-9b5d85ca624b"
  }
]

Documentation Index

Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
call_id
string<uuid>
required

Call identifier used to retrieve reports owned by the authenticated user.

Response

Raw call report stats payloads.

​
call_id
string<uuid>

Unique call identifier.

​
call_report_id
string

User-scoped storage grouping identifier derived from the authenticated user. This is not a unique per-call report identifier and may be shared by multiple calls for the same user.

​
user_id
string<uuid>

Authenticated user that owns the call report.

​
organization_id
string<uuid>

Organization associated with the stored call report when provided by the Voice SDK reporting path.

​
voice_sdk_id
string

Voice SDK instance identifier.

​
voice_sdk_session_id
string

Voice SDK session correlation identifier used to group stats segments for the same SDK session.

​
voice_sdk_id_decoded
object

Decoded Voice SDK identifier metadata emitted by voice-sdk-proxy when available.

​
user_agent
string

Voice SDK user agent string reported by the client. This is the preferred SDK/platform/version dimension when present.

​
version
string

Legacy SDK version value when the client reports one separately from the user agent.

​
telnyx_session_id
string

Telnyx RTC session identifier for correlating the report with Voice SDK signaling and media-session logs.

​
telnyx_leg_id
string

Telnyx call leg identifier for correlating the report with call-control, SIP, and media troubleshooting data.

​
summary
object

High-level call metadata.

​
stats
object

Raw stats snapshot. It may include WebRTC RTCStatsReport-style entries and audio, connection, ICE, or transport metrics.

​
logs
object

A raw Voice SDK log entry. Additional SDK-specific fields may be present.

​
flushReason
object

Reason the SDK flushed this stats report segment, for example an intermediate socket-close flush.

​
segment
integer

Zero-based stats segment index when the SDK sends segmented or intermediate reports.

​
stored_at
string<date-time>

Time when the call report was stored.

​
created_at
string<date-time>

Creation timestamp when present.