Retrieve Voice SDK call reports by call ID

Returns raw call report stats JSON payloads stored for the authenticated user and call_id. The user is derived from Telnyx authentication, not from request parameters.

GET /voice_sdk_call_reports/{call_id}

JavaScript

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);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
voice_sdk_call_reports = client.voice_sdk_call_reports.retrieve(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(voice_sdk_call_reports)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	voiceSDKCallReports, err := client.VoiceSDKCallReports.Get(context.TODO(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", voiceSDKCallReports)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.voicesdkcallreports.VoiceSdkCallReportRetrieveParams;
import com.telnyx.sdk.models.voicesdkcallreports.VoiceSdkCallReportRetrieveResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        List<VoiceSdkCallReportRetrieveResponse> voiceSdkCallReports = client.voiceSdkCallReports().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");
    }
}

require "telnyx"

telnyx = Telnyx::Client.new(api_key: "My API Key")

voice_sdk_call_reports = telnyx.voice_sdk_call_reports.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(voice_sdk_call_reports)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $voiceSDKCallReports = $client->voiceSDKCallReports->retrieve(
    '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'
  );

  var_dump($voiceSDKCallReports);
} catch (APIException $e) {
  echo $e->getMessage();
}

telnyx voice-sdk-call-reports retrieve \
  --api-key 'My API Key' \
  --call-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e

curl --request GET \
  --url https://api.telnyx.com/v2/voice_sdk_call_reports/{call_id} \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "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"
  }
]

{
  "errors": [
    {
      "code": "10015",
      "title": "Bad Request",
      "detail": "Missing required query parameter: call_id.",
      "source": {
        "parameter": "call_id",
        "pointer": "<string>"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10015"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "10015",
      "title": "Bad Request",
      "detail": "Missing required query parameter: call_id.",
      "source": {
        "parameter": "call_id",
        "pointer": "<string>"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10015"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "10015",
      "title": "Bad Request",
      "detail": "Missing required query parameter: call_id.",
      "source": {
        "parameter": "call_id",
        "pointer": "<string>"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10015"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "10015",
      "title": "Bad Request",
      "detail": "Missing required query parameter: call_id.",
      "source": {
        "parameter": "call_id",
        "pointer": "<string>"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10015"
      }
    }
  ]
}

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

200

application/json

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.

object[]

object

logs · object

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

object[]

object

Show child attributes

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.