---
title: "List Voice SDK call reports"
method: GET
path: "/voice_sdk_call_reports"
tags: ["Voice SDK Stats"]
---

# List Voice SDK call reports

`GET /voice_sdk_call_reports`

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

## Query parameters

- `page` object
  - `number` integer
  - `size` integer — Number of reports per page. Maximum 100.
- `sort` 'asc' | 'desc' | 'created_at' | '-created_at'

## Response `200`

Paginated raw call report stats payloads.

- VoiceSdkCallReportListResponse — Paginated raw Voice SDK call report stats payloads as stored by voice-sdk-debug.
  - `data` VoiceSdkCallReport[], required
    - `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.
    - `created_at` string, date-time — Creation timestamp when present.
    - `flushReason` object — Reason the SDK flushed this stats report segment, for example an intermediate socket-close flush.
    - `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.
        - `context` object — Raw structured context attached to the log entry.
        - `level` 'debug' | 'info' | 'warn' | 'error' — Log level emitted by the SDK.
        - `message` string — Log message.
        - `timestamp` string, date-time — Time when the log entry was emitted.
      - 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.
          - `context` object — Raw structured context attached to the log entry.
          - `level` 'debug' | 'info' | 'warn' | 'error' — Log level emitted by the SDK.
          - `message` string — Log message.
          - `timestamp` string, date-time — Time when the log entry was emitted.
    - `organization_id` string, uuid — Organization associated with the stored call report when provided by the Voice SDK reporting path.
    - `segment` integer — Zero-based stats segment index when the SDK sends segmented or intermediate reports.
    - `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.
    - `stored_at` string, date-time — Time when the call report was stored.
    - `summary` object — High-level call metadata.
    - `telnyx_leg_id` string — Telnyx call leg identifier for correlating the report with call-control, SIP, and media troubleshooting data.
    - `telnyx_session_id` string — Telnyx RTC session identifier for correlating the report with Voice SDK signaling and media-session logs.
    - `user_agent` string — Voice SDK user agent string reported by the client. This is the preferred SDK/platform/version dimension when present.
    - `user_id` string, uuid — Authenticated user that owns the call report.
    - `version` string — Legacy SDK version value when the client reports one separately from the user agent.
    - `voice_sdk_id` string — Voice SDK instance identifier.
    - `voice_sdk_id_decoded` object — Decoded Voice SDK identifier metadata emitted by voice-sdk-proxy when available.
    - `voice_sdk_session_id` string — Voice SDK session correlation identifier used to group stats segments for the same SDK session.
  - `meta` VoiceSdkDebugPaginationMeta, required
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `400` — Bad request — invalid pagination or sort parameter.
- `401` — Authentication failed.
- `500` — Unexpected server error while listing reports.

---

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