---
title: "Retrieve Voice SDK call reports by call ID"
method: GET
path: "/voice_sdk_call_reports/{call_id}"
tags: ["Voice SDK Stats"]
---

# Retrieve Voice SDK call reports by call ID

`GET /voice_sdk_call_reports/{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.

## Path parameters

- `call_id` string, uuid, required

## Response `200`

Raw call report stats payloads.

- VoiceSdkCallReport[] — Raw Voice SDK call report stats payloads as stored by voice-sdk-debug.
  - `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` union — Raw stats payload emitted by the Voice SDK and stored without normalization. The exact shape can vary by SDK platform and version. Live responses commonly return an array of interval snapshots, but object-shaped stats payloads are also allowed for compatibility.
    - object[] — Raw interval stats snapshots emitted by the Voice SDK.
    - object — Raw stats object emitted by the Voice SDK.
      - `audio` object — Raw audio stats such as inbound/outbound packet, byte, jitter, packet-loss, bitrate, and audio-level metrics.
      - `connection` object — Raw connection stats such as round-trip time, packets, and bytes sent or received.
      - `ice` object — Raw ICE candidate-pair information, including selected pair, local/remote candidates, state, and nomination data when provided by the SDK.
      - `transport` object — Raw transport stats such as ICE state, DTLS state, SRTP cipher, TLS version, and selected-candidate-pair changes.
  - `logs` union — Raw logs payload emitted by the Voice SDK and stored without normalization. Live responses commonly return an array of log entries, but object-shaped log payloads are also allowed for compatibility.
    - VoiceSdkCallReportLogEntry[] — Raw log entries emitted by the Voice SDK.
      - `timestamp` string, date-time — Time when the log entry was emitted.
      - `level` 'debug' | 'info' | 'warn' | 'error' — Log level emitted by the SDK.
      - `message` string — Log message.
      - `context` object — Raw structured context attached to the log entry.
    - object — Raw logs object emitted by the Voice SDK when logs are grouped under an entries field.
      - `entries` VoiceSdkCallReportLogEntry[] — Raw log entries when the SDK groups logs under an entries field.
        - `timestamp` string, date-time — Time when the log entry was emitted.
        - `level` 'debug' | 'info' | 'warn' | 'error' — Log level emitted by the SDK.
        - `message` string — Log message.
        - `context` object — Raw structured context attached to the log entry.
  - `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.

## Other responses

- `400` — Bad request — invalid path parameter.
- `401` — Authentication failed.
- `404` — No call report was found for the authenticated user and call ID.
- `500` — Unexpected server error while looking up the report.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)
