# Fetch the state of a live stream

This operation shows the current state of a live stream.

Endpoint: GET /live_streams/{id}/state
Version: v2.0

## Path parameters:

  - `id` (string, required)
    The unique alphanumeric string that identifies the live stream.

## Response 200 fields (application/json):

  - `live_stream` (object, required)

  - `live_stream.ip_address` (string)
    The IP address of the live stream instance. If the live stream state is anything other than started, the ip_address is 0.0.0.0.
    Example: "0.0.0.0"

  - `live_stream.state` (string)
    The state of the live stream.
    Enum: "started", "stopped", "starting", "stopping", "resetting"

## Response 401 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 403 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 404 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 410 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)