---
title: "Fetch details of peer"
method: GET
path: "/sessions/peer-report/{peer_id}"
tags: ["Sessions"]
---

# Fetch details of peer

`GET /sessions/peer-report/{peer_id}`

## Request

- Base URL: `https://api.dyte.io/v2`
- URL: `https://api.dyte.io/v2/sessions/peer-report/{peer_id}`
- Auth: HTTP basic

Returns details of the given peer ID along with call statistics for the given session ID.

## Path parameters

- `peer_id` string, required

## Query parameters

- `filters` 'device_info' | 'ip_information' | 'precall_network_information' | 'events' | 'quality_stats'

## Response `200`

Returns details of a participant (using peer id) along with callstats data.

- object
  - `success` boolean
  - `data` object
    - `participant` object
      - `id` string
      - `user_id` string
      - `custom_participant_id` string
      - `display_name` string
      - `role` string
      - `joined_at` string
      - `left_at` string
      - `duration` number
      - `created_at` string
      - `updated_at` string
      - `peer_stats` object
        - `events` object[]
          - `type` string
          - `timestamp` string
          - `metadata` object
            - `connection_info` object
              - …
        - `device_info` object
          - `browser` string
          - `browser_version` string
          - `cpus` integer
          - `engine` string
          - `is_mobile` boolean
          - `os` string
          - `os_version` string
          - `sdk_name` string
          - `sdk_version` string
          - `user_agent` string
          - `webgl_support` string
        - `ip_information` object
          - `city` string
          - `country` string
          - `timezone` string
          - `region` string
          - `asn` object
            - `asn` string
          - `ipv4` string
          - `ip_location` string
          - `org` string
        - `precall_network_information` object
          - `backend_rtt` number
          - `effective_networktype` string
          - `fractional_loss` integer
          - `jitter` integer
          - `reflexive_connectivity` boolean
          - `relay_connectivity` boolean
          - `rtt` number
          - `throughput` integer
          - `turn_connectivity` boolean
      - `quality_stats` object
        - `audio_stats` object[]
        - `video_stats` object[]
        - `peer_ids` string[]
        - `start` string, nullable
        - `end` string, nullable
        - `total_audio_packets` integer
        - `total_audio_packets_lost` integer
        - `total_video_packets` integer
        - `total_video_packets_lost` integer
        - `first_audio_packet_received` string
        - `first_video_packet_received` string
        - `last_audio_packet_received` string
        - `last_video_packet_received` string
        - `average_quality` integer
        - `audio_bandwidth` integer
        - `video_bandwidth` integer
      - `peer_report` object
        - `metadata` object
          - `events` object[]
            - `name` string
            - `timestamp` string
          - `pc_metadata` object[]
            - `effective_network_type` string
            - `reflexive_connectivity` boolean
            - `relay_connectivity` boolean
            - `turn_connectivity` boolean
            - `timestamp` string
          - `audio_devices_updates` object[]
          - `video_devices_updates` object[]
          - `speaker_devices_updates` object[]
          - `selected_device_updates` object[]
          - `candidate_pairs` object
            - `producing_transport` object[]
              - …
            - `consuming_transport` object[]
              - …
          - `device_info` object
            - `cpus` integer
            - `is_mobile` boolean
            - `os` string
            - `os_version` string
          - `browser_metadata` object
            - `browser` string
            - `browser_version` string
            - `engine` string
            - `user_agent` string
            - `webgl_support` string
          - `sdk_name` string
          - `sdk_version` string
          - `room_view_type` string
          - `ip_information` object
            - `city` string
            - `country` string
            - `timezone` string
            - `region` string
            - `asn` object
              - …
            - `ipv4` string
        - `quality` object
          - `video_consumer` object[]
          - `audio_consumer` object[]
          - `screenshare_video_consumer` object[]
          - `screenshare_audio_consumer` object[]
          - `video_producer` object[]
          - `audio_producer` object[]
            - `mos_quality` integer
            - `timestamp` string
            - `packets_lost` integer
            - `jitter` integer
            - `rtt` number
            - `packets_sent` integer
            - `bytes_sent` integer
            - `producer_id` string
            - `ssrc` integer
            - `mid` string
          - `screenshare_video_producer` object[]
          - `screenshare_audio_producer` object[]
          - `video_consumer_cumulative` object
          - `audio_consumer_cumulative` object
          - `screenshare_video_consumer_cumulative` object
          - `screenshare_audio_consumer_cumulative` object
          - `video_producer_cumulative` object
          - `screenshare_video_producer_cumulative` object
          - `audio_producer_cumulative` object
            - `quality_mos` object
              - …
            - `packet_loss` object
              - …
            - `rtt` object
              - …
          - `screenshare_audio_producer_cumulative` object

## Changes

- **2025-04-04** (v2) `cb67ff854c71`: 1 breaking, 1 info
  - added the new path request parameter `peer_id`
  - the endpoint scheme security `Authorization` was added to the API
- **2025-04-03** (v2) `68b9e665bfcc`: 1 warning, 1 info
  - deleted the `path` request parameter `peer_id`
  - the endpoint scheme security `Authorization` was removed from the API
- **2024-11-20** (v2) `d8c5d90e84ac`: 1 breaking, 1 info
  - added the new path request parameter `peer_id`
  - the endpoint scheme security `Authorization` was added to the API
- **2024-03-14** (v2) `3755ab4c9833`: 11 breaking
  - the response property `data/participant/quality_stats/end` became nullable for the status `200`
  - the response property `data/participant/quality_stats/start` became nullable for the status `200`
  - the `data/participant/peer_report/metadata/browser_metadata/webgl_support` response's property type changed from `null` to `string` for status `200`
  - the `data/participant/peer_report/quality/audio_producer/items/rtt` response's property type changed from `integer, number` to `number` for status `200`
  - …7 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/changes/sessions/peer-report/:peer_id/get.md)

---

[API](https://skmtc.dev/dyte-io/apis/dyte-rest-apis.md) - [All operations](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/revisions/f62d3edd92ae?raw)