---
title: "Get user media asset"
method: GET
path: "/v2/assets/{user_media_asset_id}"
tags: ["Assets"]
---

# Get user media asset

`GET /v2/assets/{user_media_asset_id}`

Retrieves a user uploaded media asset by its ID. Returns the asset's status, title, content type, and metadata including detected language if available. Currently only supports user-uploaded assets in the dubbing configuration.

## Path parameters

- `user_media_asset_id` string, uuid, required

## Response `200`

Success. Returns the media asset details.

- GetPublicApiUserUploadedAssetResponse
  - `id` string, required
  - `title` string, required — The title of the user uploaded asset.
  - `contentType` 'image/webp' | 'image/jpeg' | 'image/png' | 'image/svg+xml' | 'image/gif' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'audio/wav' | 'audio/mpeg' | 'audio/ogg' | 'audio/aac' | 'audio/flac' | 'audio/mp4' | 'audio/webm' | 'font/otf' | 'font/ttf' | 'font/woff' | 'application/font-woff' | 'font/woff2' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.synthesia.studio-video' | 'application/vnd.synthesia.studio-imported-video' | 'application/vnd.synthesia.studio-dubbed-video' | 'application/vnd.synthesia.studio-photo-avatar-video' | 'application/vnd.synthesia.studio-synthesia-academy-video' | 'application/vnd.synthesia.studio-synthesia-feature-overview-video' | 'application/vnd.synthesia.studio-synthesia-example-video' | 'application/vnd.synthesia.studio-synthesia-demo-video' | 'application/vnd.synthesia.studio-synthesia-welcome-webinar-video' | 'application/vnd.synthesia.studio-user-template' | 'application/vnd.synthesia.studio-synthesia-template' | 'application/vnd.synthesia.studio-synthesia-processed-gif' | 'application/vnd.synthesia.studio-user-course' | 'application/vnd.synthesia.font-family' | 'application/vnd.synthesia.folder' | 'application/json' | 'application/x-xliff+xml' | 'application/pdf' | 'text/csv', required — AssetContentType specifies the MIME type of a particular asset, and provides some helper methods and properties
  - `status` 'awaiting_upload' | 'processing' | 'error' | 'ready', required
  - `metadata` GetPublicApiMediaAssetMetadataResponse, required
    - `detectedLanguage` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'ba' | 'eu' | 'be' | 'bn' | 'bs' | 'br' | 'bg' | 'my' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fo' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'ht' | 'ha' | 'haw' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'la' | 'lv' | 'ln' | 'lt' | 'lb' | 'mk' | 'mg' | 'ms' | 'ml' | 'mt' | 'mi' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'oc' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sa' | 'sr' | 'sn' | 'sd' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'tl' | 'tg' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'tt' | 'te' | 'th' | 'bo' | 'tr' | 'tk' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'yi' | 'yo' | 'zu' | 'und' — A class for representing languages according to the BCP-47 standard. The standard is followed very loosely, only primary language and region sub-tags are implemented right now. The display names of the languages are derived from the enum names, with the primary language name capitalized and the region name capitalized and enclosed in parentheses if present. If you need to customize the display name for a specific language, you can override the `override_display_name` method. https://www.w3.org/International/questions/qa-choosing-language-tags
  - `errorCode` 'asset_upload' | 'language_detect' | 'unknown'

## Other responses

- `400` — Bad Request. Asset is not a valid user uploaded asset.
- `404` — Not Found. Asset does not exist or user does not have access.
- `default` — Unexpected Server error.

---

[API](https://skmtc.net/synthesia/apis/synthesia-api.md) · [All operations](https://skmtc.net/synthesia/apis/synthesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthesia/synthesia-api/revisions/f0f34ae0591d/schema)
