--- updatedAt: 2026-09-21T22:06:18.000Z agentTools: siteIndex: https://docs.jwplayer.com/llms.txt projectIndex: https://docs.jwplayer.com/platform/llms.txt --- # Get an original Retrieves an original resource, which represents the primary or secondary files of a hosted media, by ID # OpenAPI definition ```json { "openapi": "3.1.0", "servers": [ { "url": "https://api.jwplayer.com" } ], "info": { "version": "0.2", "title": "Management API v2", "description": "Customer-facing management API. This file only includes documented routes." }, "security": [ { "v2ApiSecret": [] } ], "x-explorer-enabled": true, "x-proxy-enabled": true, "x-samples-enabled": true, "x-samples-languages": [ "python", "node", "ruby", "php", "go", "java", "csharp" ], "paths": { "/v2/sites/{site_id}/media/{media_id}/originals/{original_id}/": { "get": { "summary": "Get an original", "description": "Retrieves an original resource, which represents the primary or secondary files of a hosted media, by ID\n", "tags": [ "originals" ], "parameters": [ { "$ref": "#/components/parameters/siteId" }, { "$ref": "#/components/parameters/mediaId" }, { "$ref": "#/components/parameters/originalId" } ], "responses": { "200": { "description": "Original successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OriginalResourceRead" } } } }, "404": { "$ref": "#/components/responses/404" } } } } }, "components": { "parameters": { "siteId": { "name": "site_id", "description": "Unique alphanumeric ID of the site", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/ResourceId" } }, "mediaId": { "name": "media_id", "description": "Unique alphanumeric ID of the media", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/ResourceId" } }, "originalId": { "name": "original_id", "description": "Unique identifier for an original resource", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/ResourceId" } } }, "schemas": { "OriginalResourceRead": { "allOf": [ { "$ref": "#/components/schemas/ResourceRead" }, { "type": "object", "properties": { "status": { "description": "Original status", "type": "string", "enum": [ "created", "failed", "processing", "ready", "updating" ] }, "error_message": { "description": "Human-readable message explaining an issue uploading or processing an original\n\nThis property is only displayed when `\"status\": \"failed\"`.\n", "type": "string" }, "size": { "description": "Size of the original in bytes", "type": "string" }, "container_format": { "description": "File format containing the media compressed by means of standardized audio/video codecs", "type": "string", "example": "mp4" }, "md5": { "description": "MD5 hash of the asset, stored as 32-character hexadecimal string", "type": "string" }, "original_type": { "description": "Identifies if the uploaded file is a video file (`primary`) or an alternate audio track file (`secondary`)\n", "enum": [ "primary", "secondary" ] }, "metadata": { "$ref": "#/components/schemas/OriginalMetadata" } } } ] }, "OriginalMetadata": { "type": "object", "properties": { "name": { "description": "Name of the original and fallback name of associated audio tracks.", "type": "string" }, "type": { "description": "([Alternate audio tracks](https://docs.jwplayer.com/jwplayer/docs/stream-manage-alternate-audio-tracks) only) Represents the purpose or content of the audio track and is the fallback type of associated audio tracks.\n\n**Possible values**:\n- `audio-description`: Audio descriptions of what is happening in the video\n\n- `commentary`: Commentary to accompany the video\n\n- `language`: Alternate language option than the one already present in the video\n\n- `music`: Alternate music selection\n\n- `other`: Anything else\n", "enum": [ "audio-description", "commentary", "language", "music", "other" ] }, "language": { "description": "Language dialect of the original resource and fallback language of associated audio tracks.\nWhen a `name` is not provided, `language` is used as the audio label\nSet to `English` as default on non-music type resources", "type": "string" }, "language_code": { "description": "[ISO 639-1 language code](https://id.loc.gov/vocabulary/iso639-1.html) of the original and fallback language code of associated audio tracks.\n\n This is set to `en` as default for non-music type resources", "type": "string" } } }, "ErrorResponse": { "type": "array", "description": "One or many errors indicating that something prevented the request from being performed successfully", "items": { "type": "object", "properties": { "code": { "description": "Short machine-readable identifier for the error", "type": "string", "example": "error_code" }, "description": { "description": "Human-readable message explaining the error", "type": "string", "example": "Something went wrong." } } } }, "ResourceId": { "description": "Unique identifier for a resource", "type": "string", "minLength": 8, "maxLength": 8, "example": "Ny05CEfj", "pattern": "^[A-Za-z0-9]+$" }, "ResourceRead": { "type": "object", "properties": { "schema": { "type": "string", "example": "https://schema.jwplayer.com/types/thumbnail.json" }, "id": { "$ref": "#/components/schemas/ResourceId" }, "created": { "type": "string", "description": "Date and time at which the resource was created", "example": "2019-09-25T15:29:11.042095+00:00" }, "last_modified": { "type": "string", "description": "Date and time at which the resource was most recently modified", "example": "2019-09-25T15:29:11.042095+00:00" }, "type": { "type": "string", "description": "Name of the type of resource." }, "relationships": { "type": "object", "description": "Ancilliary resources associated to the primary resource being read" } } } }, "securitySchemes": { "v2ApiSecret": { "description": "V2 API secret used for authentication", "type": "apiKey", "in": "header", "name": "Authorization" } }, "responses": { "404": { "description": "Resource with ID supplied does not exist in account and object namespace", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } ``` # Sibling pages * [List originals](https://docs.jwplayer.com/platform/reference/get_v2-sites-site-id-media-media-id-originals.md) * [Create an original](https://docs.jwplayer.com/platform/reference/post_v2-sites-site-id-media-media-id-originals.md) * [Delete an original](https://docs.jwplayer.com/platform/reference/delete_v2-sites-site-id-media-media-id-originals-original-id.md)