---
title: "Fetch ingest analytics data for a live stream"
method: GET
path: "/analytics/ingest/live_streams/{id}"
tags: ["analytics_ingest"]
---

# Fetch ingest analytics data for a live stream

`GET /analytics/ingest/live_streams/{id}`

(Available from version 1.11) This operation returns the ingest data for a specific live stream. You'll use the query parameters to return live vs historic data, as well as specific types of ingest data. 


**Querying live data**

To get data for currently live streams, do not send **include**, **from**, and **to** values.

This operation returns a hash of metrics keys, each of which identifies a status, text description, unit, and value. 

**Querying historic data**

To get data for streams that ran previously, send **include**, **from**, and **to** values. 

This operation returns a hash of metrics keys, each of which identifies a status, text description, unit, and value in addition to trend data.

## Path parameters

- `id` string, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `include` string

## Response `200`

Success

- AnalyticsIngestLiveStream
  - `live_stream` object
    - `id` string, int32 — The unique alphanumeric string that identifies the live stream.
    - `audio_codec` AudioCodecMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` string — The value of the associated key.
    - `bits_in_rate` BitsInRateMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` number, float — The value of the associated key.
    - `bytes_in_rate` BytesInRateMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` number, float — The value of the associated key.
    - `connected` ConnectedMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` string — The value of the associated key.
    - `frame_size` FrameSizeMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` string — The value of the associated key.
    - `frame_rate` FrameRateMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` integer — The value of the associated key.
    - `height` HeightMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` integer — The value of the associated key.
    - `keyframe_interval` KeyframeIntervalMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` integer — The value of the associated key.
    - `video_codec` VideoCodecMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` string — The value of the associated key. <blockquote>Note: You might see avc1 or h264 returned interchangeably.</blockquote>
    - `width` WidthMetric
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` integer — The value of the associated key.
    - `stream_target_status` object[] — An array of stream_target_status data.
      - `status` string — The status of the current key. Possible values are **normal** (everything is fine), **warning** (something may be misconfigured), and **no_data** (no data was returned, perhaps because the instance isn't running).
      - `text` string — A message related to the value and status of the current key. Usually blank unless there's a warning status.
      - `units` string — The unit of the returned value, such as **Kbps**, **bps**, **%**, **FPS**, or **GOP**.
      - `value` integer — The value of the associated key.
      - `id` string — The unique alphanumeric string that identifies the stream_target_status. This ID id created by combining the output ID and stream target ID as OUTPUTIDX_STREAMTARGETIDX.
    - `trend` TrendMetric — An array of viewer trend data. > **Note:** This parameter only returns data for Fastly stream targets.
      - `bits_in_rate` integer — The rate at which data is processed in.
      - `created_at` string — The date and time that the trend was created.
      - `frame_rate` integer — The number of frames that appear in a second.
      - `height` integer — The height of the video player, in pixels.
      - `keyframe_interval` integer — An encoding setting that determines how often the whole picture is transmitted.
      - `width` integer — The width of the video player, in pixels.
  - `limits` LimitsMetric — The time frame represented in the response.
    - `from` string, date-time — The start of the range of time represented in the response.
    - `to` string, date-time — The end of the range of time represented in the response.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `410` — Gone
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/revisions/157b6f741f2a/schema)