# Video Participant Summary

## Complete

`com.twilio.video.insights.participant-summary.complete`

Video Participant Summary Complete events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/video/troubleshooting/insights).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.video.insights.participant-summary.complete",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/VideoInsights.ParticipantSummaryApi/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "participant_sid" : "PA0000000000000000000000000000001",
    "participant_identity" : "00000000-0000-0000-0000-000000000001",
    "room_sid" : "RM0000000000000000000000000000001",
    "room_name" : "My room",
    "room_type" : "go",
    "account_sid" : "AC0000000000000000000000000000001",
    "join_time" : "2025-01-01T00:00:00.000Z",
    "leave_time" : "2025-01-01T00:01:00.000Z",
    "duration_sec" : 60,
    "recording_duration_sec" : 60,
    "status" : "in_progress",
    "processing_state" : "complete",
    "media_region" : "us1",
    "signaling_region" : "us1",
    "tracks" : {
      "audio" : 1,
      "video" : 1,
      "data" : 0
    },
    "codecs" : [
      "VP8"
    ],
    "end_reason" : "disconnected_via_api",
    "publisher_info" : {
      "name" : "twilio-video.js",
      "sdk_version" : "2.28.1",
      "device" : {
        "manufacturer" : "Unknown",
        "model" : "Other",
        "architecture" : "amd64"
      },
      "platform" : {
        "name" : "Windows",
        "version" : "10"
      },
      "browser" : {
        "name" : "Electron",
        "version" : "28.2.0"
      },
      "ip_location" : {
        "city" : "Barcelona",
        "subdivision" : "Catalunya",
        "country" : "Spain",
        "country_iso_code" : "ES",
        "geo" : {
          "lat" : 40.83885,
          "lon" : -74.04568
        }
      }
    },
    "detected_issues" : {
      "details" : [
        {
          "issue_type" : "packet_loss",
          "severity" : "high",
          "properties" : {
            "direction" : "outgoing",
            "track_sid" : "MT0000000000000000000000000000001",
            "track_type" : "localVideoTrack"
          }
        }
      ]
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **participant\_sid** (required). Unique identifier for the participant.
* `string` **participant\_identity** (required). The application-defined string that uniquely identifies the participant within a Room.
* `string` **room\_sid** (required). Unique identifier for the room.
* `string` **room\_name** (required). Description of the room.
* `string` **room\_type** (required). The type of video room depending on size restrictions and technology implementations.
* `string` **account\_sid** (required). Account SID associated with this room.
* `string` **join\_time** (required). When the participant joined the room in ISO 8601 format.
* `string` **leave\_time** (required). When the participant left the room in ISO 8601 format.
* `integer` **duration\_sec**. Amount of time in seconds the participant was in the room.
* `integer` **recording\_duration\_sec**. Combined amount of recorded seconds for participants in the room.
* `string` **status** (required). Status of the room.
* `string` **processing\_state** (required). Resource state. in-progress indicates that more details may be appended to the resource. complete indicates no further information will be added.
* `string` **media\_region** (required). Region of Twilio media servers for the room.
* `string` **signaling\_region** (required). The Twilio region where signaling was handled.
* `object` **tracks**. Tracks metadata from the participant.
  * `integer` **audio** (required). Number of audio tracks from the participant.
  * `integer` **video** (required). Number of video tracks from the participant.
  * `integer` **data** (required). Number of data tracks from the participant.
* `string[]` **codecs** (required). Video or audio codecs used by participants in the room.
* `string` **end\_reason** (required). Reason the participant left the room.
* `object` **publisher\_info**. Participant publisher metadata.
  * `string` **name**. SDK type.
  * `string` **sdk\_version**. SDK version.
  * `object` **device**. Participant device metadata.
    * `string` **manufacturer**. Identifier for the device manufacturer.
    * `string` **model**. Model of the device.
    * `string` **architecture**. System architecture for the device.
  * `object` **platform**. Participant platform metadata.
    * `string` **name**. Platform name.
    * `string` **version**. Platform version.
  * `object` **browser**. Participant browser metadata.
    * `string` **name**. Browser name.
    * `string` **version**. Version of the browser.
  * `object` **ip\_location**. Participant location metadata.
    * `string` **city**. The user's city.
    * `string` **subdivision**. The user's country subdivision, such as state, province, or locality.
    * `string` **country**. The user's country.
    * `string` **country\_iso\_code**. The user's country ISO code.
    * `object` **geo**. Participant location coordinates.
      * `number` **lat**. Latitude.
      * `number` **lon**. Longitude.
* `object` **detected\_issues**. Issues experienced by the participant.
  * `object[]` **details** (required). Array of issues the participant experienced.
    * `string` **issue\_type** (required). The type of issue the participant experienced.
    * `string` **severity** (required). The severity of issue the participant experienced.
    * `object` **properties**. Participant issue properties.
      * `string` **direction** (required). The video/audio direction.
      * `string` **track\_sid**. The unique identifier for the track.
      * `string` **track\_type** (required). The type of track.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/VideoInsights.ParticipantSummaryApi/2).

#### v1

* `string` **participant\_sid** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **participant\_identity** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **room\_sid** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **room\_name** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **room\_type** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **account\_sid** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **join\_time** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **leave\_time** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `integer` **duration\_sec**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `integer` **recording\_duration\_sec**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **status** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **processing\_state** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **media\_region** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **signaling\_region** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `object` **tracks**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `integer` **audio** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `integer` **video** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `integer` **data** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string[]` **codecs** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `string` **end\_reason** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `object` **publisher\_info**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `string` **name**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `string` **sdk\_version**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `object` **device**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **manufacturer**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **model**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **architecture**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `object` **platform**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **name**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **version**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `object` **browser**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **name**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **version**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `object` **ip\_location**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **city**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **subdivision**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **country**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **country\_iso\_code**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `object` **geo**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
      * `number` **lat**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
      * `number` **lon**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
* `object` **detected\_issues**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
  * `object[]` **details** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **issue\_type** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `string` **severity** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
    * `object` **properties**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
      * `string` **direction** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
      * `string` **track\_sid**. Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.
      * `string` **track\_type** (required). Https://www.twilio.com/docs/video/insights/api/participant-summary-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/VideoInsights.ParticipantSummaryApi/1).