# Fetch a stream target

This operation shows the details of a specific stream target whether it be a Wowza CDN, custom, Facebook Live, or LinkedIn Live stream target.

Endpoint: GET /stream_targets/{id}
Version: v2.0

## Path parameters:

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

## Response 200 fields (application/json):

  - `stream_target_custom` (object)
    Example: {"created_at":"2020-01-28T17:16:22.011Z","delivery_protocols":["rtmp"],"id":"RMS45lfvx","name":"My Custom Stream Target","playback_urls":{"rtmp":[{"name":"default","url":"rtmp://cp123456.live.edgefcs.net/live/[EVENT]@654321"}]},"primary_url":"rtmp://p.ep123456.i.akamaientrypoint.net/EntryPoint","provider":"rtmp","stream_name":"c8467d50@123456","updated_at":"2020-01-30T19:14:11.011Z"}

  - `stream_target_custom.backup_url` (string)
    The backup ingest URL for a custom stream target. Not for use with the akamai_cupertino custom provider.

  - `stream_target_custom.created_at` (string)
    The date and time that the custom stream target was created.
    Example: "2020-01-28T17:16:22.011Z"

  - `stream_target_custom.delivery_protocols` (array)
    An array of the delivery protocols available for this stream target. Available from version 1.7.
    Example: ["rtmp"]

  - `stream_target_custom.id` (string)
    The unique alphanumeric string that identifies the custom stream target.
    Example: "RMS45lfvx"

  - `stream_target_custom.name` (string)
    A descriptive name for the custom stream target. Maximum 255 characters.
    Example: "My Custom Stream Target"

  - `stream_target_custom.password` (string)
    A username must be present. The password associated with the target username for RTMP authentication. Not for use with the akamai_cupertino custom provider.

  - `stream_target_custom.playback_urls` (object)
    Web addresses that the target uses to play streams. Available from version 1.7.
    Example: {"rtmp":[{"name":"default","url":"rtmp://cp123456.live.edgefcs.net/live/[EVENT]@654321"}]}

  - `stream_target_custom.playback_urls.hls` (array)
    Web address that the target uses to play HLS streams.

  - `stream_target_custom.playback_urls.hls.name` (string)
    The name of the playback URL.
    Example: "default"

  - `stream_target_custom.playback_urls.hls.url` (string)
    The playback URL.

  - `stream_target_custom.playback_urls.hds` (array)
    Web address that the target uses to play HDS streams. Not for use with the akamai_cupertino custom provider.

  - `stream_target_custom.playback_urls.rtmp` (array)
    Web address that the target uses to play RTMP streams.
    Example: [{"name":"default","url":"rtmp://cp123456.live.edgefcs.net/live/[EVENT]@654321"}]

  - `stream_target_custom.primary_url` (string)
    The primary ingest URL of the custom stream target.
    Example: "rtmp://p.ep123456.i.akamaientrypoint.net/EntryPoint"

  - `stream_target_custom.provider` (string)
    The CDN for the target.
    Example: "rtmp"

  - `stream_target_custom.stream_name` (string)
    The name of the stream being ingested into the target.
    Example: "c8467d50@123456"

  - `stream_target_custom.updated_at` (string)
    The date and time that the custom stream target was updated.
    Example: "2020-01-30T19:14:11.011Z"

  - `stream_target_custom.username` (string)
    The username or ID that the target uses for RTMP authentication. Not for use with the akamai_cupertino custom provider.

  - `stream_target_wowza_cdn` (object)
    Example: {"id":"abc45lfyz","name":"My Wowza CDN Stream Target","state":"activated","stream_name":"9a00105a","delivery_protocols":["hls"],"playback_urls":{"hls":[{"name":"default","url":"https://wowzasubdomain.wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8"}]},"token_auth_enabled":false,"token_auth_playlist_only":false,"geoblock_enabled":true,"geoblock_by_location":"allow","geoblock_country_codes":"DE, US","geoblock_ip_override":"deny","geoblock_ip_addresses":"77.12.34.567, 78.23.45.678","referer_enabled":true,"referer_allow_empty":false,"referer_policy":"allow","referer_domains":"example.com, example2.com","force_ssl_playback":false,"created_at":"2020-01-28T17:16:22.086Z","updated_at":"2020-01-30T15:33:43.086Z"}

  - `stream_target_wowza_cdn.created_at` (string)
    The date and time that the stream target was created.
    Example: "2020-01-28T17:16:22.086Z"

  - `stream_target_wowza_cdn.custom_origin_region` (string)
    The region where your Wowza Streaming Engine instance is located. Available from version 1.6.

  - `stream_target_wowza_cdn.custom_origin_url` (string)
    The Wowza Streaming Engine instance's domain or IP address. Available from version 1.6.

  - `stream_target_wowza_cdn.url_suffix` (string)
    The path appended to the end of the playback url to make it a valid URL, to have playback through the Wowza Video Flowplayer. This is available for HLS playback only and necessary for stream targets with a custom origin.

You must have a url_suffix to enable the Share Stream feature for this stream target. The Share Stream feature enables you to host the player and use the Wowza Video player for your viewers to view your stream.   

Example: "custom_origin/cW8JTDFr"

  - `stream_target_wowza_cdn.force_ssl_playback` (boolean)
    If true, requires users to play the stream over HTTPS. If false, the default, users can play the stream over HTTPS or HTTP.

  - `stream_target_wowza_cdn.geoblock_enabled` (boolean)
    If true, controls access to the stream from specific locations and, optionally, IP addresses. The default is false.
    Example: true

  - `stream_target_wowza_cdn.geoblock_by_location` (string)
    Specifies whether to allow or deny access to the stream from specific locations. The default is disabled.
    Enum: "allow", "deny", "disabled"

  - `stream_target_wowza_cdn.geoblock_country_codes` (string)
    Required when geoblock_by_location is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list of capitalized two-letter ISO 3166-1 country codes. For a list, see [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) on Wikipedia.
    Example: "DE, US"

  - `stream_target_wowza_cdn.geoblock_ip_override` (string)
    Specifies whether specific IP addresses can override the locations that are allowed or restricted. allow permits access from IP addresses within a location that's been blocked, while deny restricts access from IP addresses within locations that are allowed. The default is disabled.
    Enum: "allow", "deny", "disabled"

  - `stream_target_wowza_cdn.geoblock_ip_addresses` (string)
    Required when geoblock_ip_override is allow or deny. Addresses that can access or restrict the stream even if they're within a specified geo-blocked location. Enter a comma-separated list of IPv4 and IPv6 IP addresses that always allow or deny streaming based on the geoblock_ip_override value.
    Example: "77.12.34.567, 78.23.45.678"

  - `stream_target_wowza_cdn.id` (string)
    The unique alphanumeric string that identifies the stream target.
    Example: "abc45lfyz"

  - `stream_target_wowza_cdn.name` (string)
    A descriptive name for the stream target. Maximum 255 characters.
    Example: "My Wowza CDN Stream Target"

  - `stream_target_wowza_cdn.playback_urls` (object)
    Web addresses that the target uses to play streams.
    Example: {"hls":[{"name":"default","url":"https://wowzasubdomain.wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8"}]}

  - `stream_target_wowza_cdn.state` (string)
    The state of the stream target.
    Enum: "activated", "archived"

  - `stream_target_wowza_cdn.referer_enabled` (boolean)
    If true, controls access to the stream from specific domains. The client or player requesting access to the stream must send the Referer header so the origin of the request can be validated. The default is false.

Note: If you change referer_enabled to false after configuring the referer policy, then later re-enable it, you'll need to re-configure the other referer policy values as well.
Available from version 1.7. For more information about the Referer header, see the [HTTP specification](https://tools.ietf.org/html/rfc7231#section-5.5.2).
    Example: true

  - `stream_target_wowza_cdn.referer_allow_empty` (boolean)
    The Referer header sent by the client or player can be empty and not identify the origin of the request. The default is false when referer_enabled is true. While less secure, if you know you'll have viewers with a client or player that won't send a Referer header, you can specify true to allow an empty Referer header so those viewers can still access the stream.

Available from version 1.7.

  - `stream_target_wowza_cdn.referer_policy` (string)
    Specifies whether to allow or deny access to the stream from specific domains. The default is allow when referer_enabled is true. Specify the domains to allow or deny in referer_domains.

Available from version 1.7.
    Enum: "allow", "deny"

  - `stream_target_wowza_cdn.referer_domains` (string)
    Domains that are either allowed or blocked from accessing the stream. Enter a comma-separated list of domains that are always allowed or denied access based on the referer_policy value. Required when referer_enabled is true.

We recommend you enter the simplest form of the domain as possible, but you do need to build out the domain to the level of subdomains you want to allow or deny. You can fully express to the subdomain (_mysubdomain.example.com_) to specify that single, specific subdomain or you can use a wildcard (*) to cover all subdomains at a specific level (_*.example.com_).

Example: _example.com, .example.com, .mysubdomain.example.com_

If you entered the above example value for referer_domains, and referer_policy is allow, the following domains are allowed access to the stream:  https://example.com https://subdomain.example.com, https://subdomain2.example.com, etc. https://subdomainA.mysubdomain.example.com, https://subdomainB.mysubdomain.example.com, etc. 

Available from version 1.7.
    Example: "example.com, example2.com"

  - `stream_target_wowza_cdn.token_auth_enabled` (boolean)
    If true, token authentication protects the stream by ensuring that it's delivered only to authorized viewers and can't be shared by unauthorized links or player hijacking attacks. The default is false.

  - `stream_target_wowza_cdn.token_auth_shared_secret` (string)
    The shared secret of the token authentication. Must contain only hexadecimal characters and be an even number of total characters not exceeding 32.

  - `stream_target_wowza_cdn.token_auth_playlist_only` (boolean)
    If true, Wowza Video uses token authentication to protect the master playlist only and leaves individual media playlists and media segments unprotected.  This feature enables playback compatibility with media players that don’t support the withCredentials property. It may also be useful when addressing  token auth compatibility issues with specific browsers. The default is false.

Note: If you've enabled MPEG-DASH on your stream target, token_auth_playlist_only applies to both the playlist.m3u8 for HLS and manifest.mpd for MPEG-DASH.

  - `stream_target_wowza_cdn.updated_at` (string)
    The date and time that the stream target was updated.
    Example: "2020-01-30T15:33:43.086Z"

  - `stream_target_facebook` (object)
    Example: {"created_at":"2020-01-28T17:16:22.011Z","id":"RMS45lfvx","type":"FAcebookStreamTarget","name":"My Facebook Stream Target","title":"My Facebook Stream Target","description":"This is my Facebook stream.","delivery_protocols":["rtmp"],"facebook_resource_id":277111822674604,"facebook_resource_type":"timeline","facebook_save_vod":true,"facebook_token":"EAAX01HBCtQ0BO0LTScgBW4OLwqqI9DZAVLwu6lUDbKhfQH5leQnJu3FvNn9d5p32YZAgKZByLUxKiSZCcZBsUm72TPwnW3NiZCgZAKbn8jkvqUE2TRnVZBcSjeSt3eCctlYS8VPfGRm2Sew9h4C4MNvNtS8FuEckrZCE1putjYaPOWzVphAZCDAZBKlw62u","facebook_privacy":"self","updated_at":"2020-01-30T19:14:11.011Z"}

  - `stream_target_facebook.title` (string)
    The title of the stream target.
    Example: "My Facebook Stream Target"

  - `stream_target_facebook.delivery_protocols` (array)
    An array of the delivery protocols available for this stream target.
    Example: ["rtmp"]

  - `stream_target_facebook.facebook_privacy` (string)
    The Facebook setting that determines who can watch your stream.
    Enum: "self", "all_friends", "friends_of_friends", "everyone"

  - `stream_target_facebook.facebook_resource_id` (integer)
    A unique identifier assigned to each individual item (like a post, page, ad, or user) within the Facebook platform.
    Example: 277111822674604

  - `stream_target_facebook.facebook_resource_type` (string)
    The video's destination within Facebook where users can view the stream.
    Example: "timeline"

  - `stream_target_facebook.facebook_save_vod` (boolean)
    Whether or not the video data should be saved for later consumption in VOD format. This is set to true by default. This can only be set at the time of creation.
    Example: true

  - `stream_target_facebook.facebook_token` (string)
    A unique alphanumeric string that identifies a user, app, or page and allows an application to access an API.
    Example: "EAAX01HBCtQ0BO0LTScgBW4OLwqqI9DZAVLwu6lUDbKhfQH5leQnJu3FvNn9d5p32YZAgKZByLUxKiSZCcZBsUm72TPwnW3NiZCgZAKbn8jkvqUE2TRnVZBcSjeSt3eCctlYS8VPfGRm2Sew9h4C4MNvNtS8FuEckrZCE1putjYaPOWzVphAZCDAZBKlw62u"

  - `stream_target_facebook.type` (string)
    The type of stream target returned.
    Enum: "FacebookStreamTarget"

  - `stream_target_linkedin` (object)
    Example: {"id":"RMS45lfvx","title":"LinkedIn Live","description":"This is my LinkedIn Live stream.","region":"WEST_EUROPE","name":"My LinkedIn Stream Target","urn":"Xd4aGv6ZXR","member_type":"person","member_description":"Drew Bennet","access_token":"AQW4H_TnVj9jgYr7U2WjTTq60R31xsjmSXvdJ_2QHF2h07rqfoa7Jm8fdlV8BHmpOE8cgBGH7e4F8eUcuQrsg_Jam11U4NOdlA7M5C5T6cAwlRJDZ-gGn-eRb97cfqEolZLymX8Mb3RV_DaPCm2NYXsOZUhRbz52cWFnNfdzcFWmo5KqJY8gXD4TwBbNSTu5KW3nRO9X7gQuDSTOvP-IaJFKzSqTxsCDZDrKmi4D9mwPGW1vo9ED4-6CCB9XFGq8Bvn4XOn03AjVY1SM61xP5G5K0aIxM4OnBWgHP3SSEiDpglmrm96mepYc8tuekIsERkaydSfGxTXgOyfKy7kP1HrpXzarBw","access_token_expires_at":"2024-12-15","created_at":"2023-01-28T17:16:22.011Z","updated_at":"2024-01-30T19:14:11.011Z"}

  - `stream_target_linkedin.member_type` (string)
    Indicates wethher you're streaming into LinkedIn as a person or organization.
    Enum: "person", "organization"

  - `stream_target_linkedin.description` (string)
    An optional description of the stream target.
    Example: "This is my LinkedIn Live stream."

  - `stream_target_linkedin.region` (string)
    The region that is closest to the broadcast location of your transcoder.
    Enum: "WEST_US", "EAST_US_NORTH", "EAST_US_SOUTH", "CENTRAL_US", "SOUTH_CENTRAL_US", "SOUTH_AMERICA", "SOUTHEAST_ASIA", "CENTRAL_INDIA", "NORTH_EUROPE", "WEST_EUROPE"

  - `stream_target_linkedin.urn` (string)
    A globally unique alphanumeric identifier used to represent an entity's association in an API.
    Example: "Xd4aGv6ZXR"

  - `stream_target_linkedin.member_description` (string)
    A description of the person or organization.
    Example: "Drew Bennet"

  - `stream_target_linkedin.access_token` (string)
    A unique alphanumeric string that allows access to LinkedIn from Wowza Video. When the token expires, you must log in again.
    Example: "AQW4H_TnVj9jgYr7U2WjTTq60R31xsjmSXvdJ_2QHF2h07rqfoa7Jm8fdlV8BHmpOE8cgBGH7e4F8eUcuQrsg_Jam11U4NOdlA7M5C5T6cAwlRJDZ-gGn-eRb97cfqEolZLymX8Mb3RV_DaPCm2NYXsOZUhRbz52cWFnNfdzcFWmo5KqJY8gXD4TwBbNSTu5KW3nRO9X7gQuDSTOvP-IaJFKzSqTxsCDZDrKmi4D9mwPGW1vo9ED4-6CCB9XFGq8Bvn4XOn03AjVY1SM61xP5G5K0aIxM4OnBWgHP3SSEiDpglmrm96mepYc8tuekIsERkaydSfGxTXgOyfKy7kP1HrpXzarBw"

## 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)