# Fetch an asset

The assets operations are deprecated in 2.0. Use the /videos endpoints instead.

This operation shows the details of a specific asset.

The fields returned vary depending on when you send this request. For example, if a resource hasn't been created yet during the processing state, you won't see available_renditions in the response.

Tip: If your original upload URL expired and you need a new one for an asset, send this request and the response will contain a new upload URL.

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

## Path parameters:

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

## Response 200 fields (application/json):

  - `asset` (object, required)

  - `asset.available_renditions` (array)
    The renditions available for the asset.
    Example: [{"height":480,"width":848,"bitrate_kbps":1600}]

  - `asset.available_renditions.height` (integer)
    The height, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1080.
    Example: 480

  - `asset.available_renditions.width` (integer)
    The width, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1920.
    Example: 848

  - `asset.available_renditions.bitrate_kbps` (integer)
    The video bitrate, in kilobits per second (Kbps). Must be between 1 and 10240. The default is 4000.
    Example: 1600

  - `asset.id` (string)
    The unique alphanumeric string that identifies the asset
    Example: "i4qsbwvi"

  - `asset.name` (string)
    A descriptive name for the live stream. Maximum 200 characters.
    Example: "My Asset"

  - `asset.description` (string)
    A description of the asset. Maximum 16,000 characters.
    Example: "My Asset Description"

  - `asset.published` (boolean)
    Specifies whether an asset is published, which enables playback.

  - `asset.tags` (array)
    A list of tags associated with the asset.
    Example: ["Tag1","Tag2","Tag3"]

  - `asset.upload_url` (string)
    The upload location for the asset. Use this URL to upload the .mp4 assets to the Wowza Video Asset Manager.

Only returned when the asset is in the uploading state, and returns a new upload URL. Useful if the previous upload URL expired and you need a new one.
    Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/p/k9bGRcyPFPtdeQeTRgAVTByIVVS0Z_EKrLBu3TusTrRfBuIpoDyio_ZY3qJM55tp/n/a1b2c3d4e5f6/b/recordings-qa-S7I69eYn/o/uploads/recording_bry7vv0s/MyAsset.mp4"

  - `asset.vod_stream_id` (string)
    An ID for the VOD. You can use this to fetch additional information about the VOD stream associated with the asset, such as the size of only the VOD stream.
    Example: "l9qsbwvf"

  - `asset.recording_id` (string)
    An ID for the recording. You can use this to fetch additional information about the recording associated with the asset.
    Example: "l8qsbwvu"

  - `asset.state` (string)
    The state of the asset.
    Enum: "uploading", "processing", "completed", "failed"

  - `asset.reason` (string)
    The reason that an asset has the state failed. Only returned when state is failed after processing is attempted.

  - `asset.created_at` (string)
    The date and time that the asset was created in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMTHH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset.
    Example: "2021-06-30T18:02:20.000Z"

  - `asset.updated_at` (string)
    The date and time that the asset was updated in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMTHH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset.
    Example: "2021-06-30T18:02:20.000Z"

  - `asset.download_url` (string)
    The URL that can be used to download the asset as a .MP4 file.
    Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset.mp4"

  - `asset.file_size` (integer)
    The file size of the asset in bytes. For example, 2372820 bytes equals 2.4 megabytes.
    Example: 2372820

  - `asset.duration` (integer)
    The length of an asset in seconds. For example, 9241 would represent 9,241 seconds or roughly 2.5 hours.
    Example: 9241

  - `asset.thumbnail_url` (string)
    The URL to receive the preview thumbnail.
    Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg"

  - `asset.unique_viewers` (integer)
    The unique_viewers parameter is deprecated. To get unique viewers for an asset, use the GET /analytics/viewers/vod_stream/{id} endpoint.
    Example: 5986

  - `asset.total_viewing_time` (integer)
    The total_viewing_time parameter is deprecated.
    Example: 4492549

  - `asset.average_view_time` (integer)
    The average_view_time parameter is deprecated.
    Example: 12580

  - `asset.playback_url` (string)
    The HLS URL for the stream associated with the asset.
    Example: "https://cdn3-qa.wowza.com/2/T1R6V2hBV2hEdmJ0/ZnJUOE9q/hls/g7z7bwbz/playlist.m3u8"

  - `asset.total_storage_size` (integer)
    The total storage size for the asset in bytes. In this example, 19513598 equals 19.5 megabytes.
    Example: 19513598

  - `asset.file_name` (string)
    The name of the mp4 file you uploaded.

Note: To avoid file management issues in storage, Wowza Video removes or replaces special characters in file names.
    Example: "MyAsset.mp4"

  - `asset.processing_percentage` (integer)
    A percentage that describes how soon transcoding will complete.
    Example: 100

  - `asset.player_embed_code` (string)
    The HTML code that can be used in external webpage to host the Wowza Flowplayer.
    Example: "<div id='wowza_player'></div>\\n<script id='player_embed' src='//player.video.wowza.com/qa/xhb9jdmc/wowza.js' type='text/javascript'></script>\\n"

  - `asset.hosted_page` (object)
    Configuration of the hosted page.

  - `asset.hosted_page.title` (string)
    A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags.

Example: "title": "My Hosted Page"
    Example: "My Hosted Page"

  - `asset.hosted_page.url` (string)
    The URL of the Wowza Video-hosted webpage that viewers can visit to watch the stream.
    Example: "https://embed.flowplayer.com/hosted/default/e8dk5bf6"

  - `asset.hosted_page.description` (string)
    A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags.

Example: "description": "My Hosted Page Description"
    Example: "This is my hosted page."

  - `asset.hosted_page.logo_image_url` (string)
    A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller.

Example: "logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]"
    Example: "[Base64-encoded string representation of GIF, JPEG, or PNG file]"

  - `asset.hosted_page.sharing_icons` (boolean)
    Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons.

Example: "sharing_icons": false

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