# Video Track Summary

## Complete

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

Video Track 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.track-summary.complete",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/VideoInsights.TrackSummaryApi/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "account_sid" : "AC0000000000000000000000000000001",
    "room_sid" : "RM0000000000000000000000000000001",
    "participant_sid" : "PA0000000000000000000000000000001",
    "track_sid" : "MT0000000000000000000000000000001",
    "track_type" : "localVideoTrack",
    "direction" : "outbound",
    "codec" : "VP8",
    "start_time" : "2025-01-01T00:00:00.000Z",
    "end_time" : "2025-01-01T00:00:00.000Z",
    "duration_secs" : 120,
    "metrics" : {
      "packets" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      },
      "packets_lost" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      },
      "bytes" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      },
      "bitrate_kbps" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      },
      "round_trip_time_ms" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      },
      "frame_rate" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      },
      "jitter_ms" : {
        "count" : 10,
        "percentage" : 15.23,
        "avg" : 5.12,
        "min" : 1.23,
        "max" : 9.26,
        "p25" : 2.22,
        "p50" : 5.01,
        "p99" : 9.2,
        "p75" : 7.99
      }
    },
    "detected_issues" : {
      "details" : [
        {
          "issue_type" : "packet_loss",
          "severity" : "high"
        }
      ]
    }
  }
}
```

**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` **account\_sid** (required). Account SID associated with this room.
* `string` **room\_sid** (required). Unique identifier for the room.
* `string` **participant\_sid** (required). Unique identifier for the participant.
* `string` **track\_sid** (required). The unique identifier for the track.
* `string` **track\_type** (required). The type of track.
* `string` **direction** (required). The audio/video direction.
* `string` **codec** (required). Codec used by participants in the room.
* `string` **start\_time** (required). Start time of the track in ISO 8601.
* `string` **end\_time** (required). End time of the track in ISO 8601.
* `integer` **duration\_secs**. Total track duration from create time to end time.
* `object` **metrics**. Track summary metrics.
  * `object` **packets**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
  * `object` **packets\_lost**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
  * `object` **bytes**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
  * `object` **bitrate\_kbps**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
  * `object` **round\_trip\_time\_ms**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
  * `object` **frame\_rate**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
  * `object` **jitter\_ms**. Track metric statistics.
    * `integer` **count**. Number of occurrences.
    * `number` **percentage**. Percentage.
    * `number` **avg**. Average value.
    * `number` **min**. Minimum value.
    * `number` **max**. Maximum value.
    * `number` **p25**. 25th percentile value.
    * `number` **p50**. 50th percentile value.
    * `number` **p99**. 99th percentile value.
    * `number` **p75**. 75th percentile value.
* `object` **detected\_issues**. Issues detected in a track.
  * `object[]` **details** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `string` **issue\_type** (required). The type of issue the participant experienced.
    * `string` **severity** (required). The severity of issue the participant experienced.

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

#### v1

* `string` **account\_sid** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **room\_sid** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **participant\_sid** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **track\_sid** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **track\_type** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **direction** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **codec** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **start\_time** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `string` **end\_time** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `integer` **duration\_secs**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `object` **metrics**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **packets**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **packets\_lost**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **bytes**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **bitrate\_kbps**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **round\_trip\_time\_ms**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **frame\_rate**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object` **jitter\_ms**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `integer` **count**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **percentage**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **avg**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **min**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **max**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p25**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p50**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p99**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `number` **p75**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
* `object` **detected\_issues**. Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
  * `object[]` **details** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `string` **issue\_type** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.
    * `string` **severity** (required). Https://www.twilio.com/docs/video/insights/api/track-summary-resource.

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