# Get the version history of an Asset.

Retrieve a list of all versions of an Asset by specifying an Object ID or Original File ID in the request path.

The user requesting the Asset must have view access to the Asset in order to retrieve the Asset version history.

Endpoint: GET /asset/{id}/version
Version: 1.0
Security: ApiKeyAuth, BasicAuth

## Header parameters:

  - `X-API-Key` (string, required)
    Customer-specific API key required to invoke API.

  - `Authorization` (string, required)
    Provided by Authentication Token creation operation

  - `AccessToken` (string, required)
    JWT token provided by Authentication Token creation operation.

## Path parameters:

  - `id` (string, required)
    Object ID or File ID of the asset.

## Response 200 fields (application/json):

  - `createdBy` (string)
    User ID who created this Asset
    Example: "7d675ef0-f423-11e9-8071-89c0c405214e"

  - `createdEpoch` (integer)
    Creation time in milliseconds
    Example: 1608745510614

  - `currentVersion` (string)
    Current version flag
    Enum: "Y", "N"

  - `customerId` (string)
    Customer ID of Created By User's Account
    Example: "123203455"

  - `fileId` (string)
    Asset File ID

  - `filename` (string)
    Asset content file name
    Example: "adventure-alps-beautiful-landscape-2444403.jpg"

  - `fileState` (string)
    Asset content file state
    Enum: "available", "recycle bin"

  - `lastUpdatedBy` (any)
    User ID who last updated the asset
    Example: "7d675ef0-f423-11e9-8071-89c0c40133ds"

  - `lastUpdatedEpoch` (integer)
    Last update time in milliseconds
    Example: 1612333543954

  - `metadata` (array)
    Array of metadata attributes

  - `metadataDenormalized` (object)
    Metadata document is a flat list of metadata attributes and values, where values are either in text values or foreign keys / referential values

  - `metadataState` (string)
    Asset metadata state
    Enum: "available", "recycle bin"

  - `metadataTemplateId` (string)
    Metadata Template ID
    Example: "ea6eb24d-adef-4380-bd02-f64f567c437f"

  - `objectId` (string)
    Asset Object ID
    Example: "e6f4bd5e-9bea-43cb-b15e-22582fa5322e"

  - `objectType` (string)
    Asset Object type
    Enum: "Asset"

  - `originalFileId` (string)
    The ID of the original version of the file
    Example: "003391e4-e78a-4186-b2d7-b5d4fcbe445d"

  - `renditions` (object)
    Renditions details

  - `renditions.width` (integer)
    Example: 4000

  - `renditions.imageThumb` (string)
    Example: "https://host.io/1571671854145/3a76743f-45f6-4d30-a7d4-05de2dc8c232/cc8f089a-1464-89d5-42f6-77217a9f09f2-200x200.png"

  - `renditions.imagePreview` (string)
    Example: "https://host.io/1571671854145/3a76743f-45f6-4d30-a7d4-05de2dc8c232/cc8f089a-1464-42f6-89d5-77217a9f09f2-700x700.png"

  - `renditions.fpo` (string)
    Example: "https://host.io/1571671854145/3a76743f-45f6-4d30-a7d4-05de2dc8c232/adventure-alps-beautiful-landscape-2444403-fpo.png"

  - `renditions.imagePreviewLarge` (string)
    Example: "https://host.io/1571671854145/3a76743f-45f6-4d30-a7d4-05de2dc8c232/cc8f089a-1464-42f6-89d5-77217a9f09f2-1000x1000.png"

  - `renditions.mezzaninePreview` (string)
    Example: "https://host.io/1571671854145/3a76743f-45f6-4d30-a7d4-05de2dc8c232/adventure-alps-beautiful-landscape-2444403-3000x3000.png"

  - `renditions.height` (integer)
    Example: 6000

  - `securityTemplateIds` (array)
    List of Security Template IDs
    Example: ["7d6f4e30-f423-11e9-8071-89c0c4052156"]

  - `securityDenormalized` (array)

  - `securityDenormalized.groupId` (string)
    Example: "7d6207c0-f423-11e9-8071-89c0c4052141"

  - `securityDenormalized.permissions` (array)
    Example: ["d0bbfb23-9304-4eb0-9c60-8e6e27a580d9"]

  - `technicalMetadata` (object)
    Technical metadata about the asset

  - `technicalMetadata.tenovos_metadata` (object)
    Core technical metadata

  - `technicalMetadata.tenovos_metadata.fileName` (string)
    Example: "adventure-alps-beautiful-landscape-2444403.jpg"

  - `technicalMetadata.tenovos_metadata.fileSize` (string)
    Example: "4.4 MB"

  - `technicalMetadata.tenovos_metadata.MD5Checksum` (string)
    Example: "6cbc612262877e8502904ea3ffd6a278"

  - `technicalMetadata.image_metadata` (object)

  - `technicalMetadata.image_metadata.fileType` (string)
    Example: "JPEG"

  - `technicalMetadata.image_metadata.fileTypeExtension` (string)
    Example: "jpg"

  - `technicalMetadata.image_metadata.mimeType` (string)
    Example: "image/jpeg"

  - `technicalMetadata.image_metadata.jfifVersion` (string)
    Example: "1.01"

  - `technicalMetadata.image_metadata.resolutionUnit` (string)
    Example: "inches"

  - `technicalMetadata.image_metadata.xResolution` (string)
    Example: "72"

  - `technicalMetadata.image_metadata.yResolution` (string)
    Example: "72"

  - `technicalMetadata.image_metadata.profileCMMType` (string)
    Example: "Linotronic"

  - `technicalMetadata.image_metadata.profileVersion` (string)
    Example: "2.1.0"

  - `technicalMetadata.image_metadata.profileClass` (string)
    Example: "Display Device Profile"

  - `technicalMetadata.image_metadata.colorSpaceData` (string)
    Example: "RGB"

  - `technicalMetadata.image_metadata.profileConnectionSpace` (string)
    Example: "XYZ"

  - `technicalMetadata.image_metadata.profileDateTime` (string)
    Example: "1998:02:09 06:49:00"

  - `technicalMetadata.image_metadata.profileFileSignature` (string)
    Example: "acsp"

  - `technicalMetadata.image_metadata.primaryPlatform` (string)
    Example: "Microsoft Corporation"

  - `technicalMetadata.image_metadata.cmmFlags` (string)
    Example: "Not Embedded, Independent"

  - `technicalMetadata.image_metadata.deviceManufacturer` (string)
    Example: "Hewlett-Packard"

  - `technicalMetadata.image_metadata.deviceModel` (string)
    Example: "sRGB"

  - `technicalMetadata.image_metadata.deviceAttributes` (string)
    Example: "Reflective, Glossy, Positive, Color"

  - `technicalMetadata.image_metadata.renderingIntent` (string)
    Example: "Perceptual"

  - `technicalMetadata.image_metadata.connectionSpaceIlluminant` (string)
    Example: "0.9642 1 0.82491"

  - `technicalMetadata.image_metadata.profileCreator` (string)
    Example: "Hewlett-Packard"

  - `technicalMetadata.image_metadata.profileID` (string)
    Example: "0"

  - `technicalMetadata.image_metadata.profileCopyright` (string)
    Example: "Copyright (c) 1998 Hewlett-Packard Company"

  - `technicalMetadata.image_metadata.profileDescription` (string)
    Example: "sRGB IEC61966-2.1"

  - `technicalMetadata.image_metadata.mediaWhitePoint` (string)
    Example: "0.95045 1 1.08905"

  - `technicalMetadata.image_metadata.mediaBlackPoint` (string)
    Example: "0 0 0"

  - `technicalMetadata.image_metadata.redMatrixColumn` (string)
    Example: "0.43607 0.22249 0.01392"

  - `technicalMetadata.image_metadata.greenMatrixColumn` (string)
    Example: "0.38515 0.71687 0.09708"

  - `technicalMetadata.image_metadata.blueMatrixColumn` (string)
    Example: "0.14307 0.06061 0.7141"

  - `technicalMetadata.image_metadata.deviceMfgDesc` (string)
    Example: "IEC http://www.iec.ch"

  - `technicalMetadata.image_metadata.deviceModelDesc` (string)
    Example: "IEC 61966-2.1 Default RGB color space - sRGB"

  - `technicalMetadata.image_metadata.viewingCondDesc` (string)
    Example: "Reference Viewing Condition in IEC61966-2.1"

  - `technicalMetadata.image_metadata.viewingCondIlluminant` (string)
    Example: "19.6445 20.3718 16.8089"

  - `technicalMetadata.image_metadata.viewingCondSurround` (string)
    Example: "3.92889 4.07439 3.36179"

  - `technicalMetadata.image_metadata.viewingCondIlluminantType` (string)
    Example: "D50"

  - `technicalMetadata.image_metadata.luminance` (string)
    Example: "76.03647 80 87.12462"

  - `technicalMetadata.image_metadata.measurementObserver` (string)
    Example: "CIE 1931"

  - `technicalMetadata.image_metadata.measurementBacking` (string)
    Example: "0 0 0"

  - `technicalMetadata.image_metadata.measurementGeometry` (string)
    Example: "Unknown"

  - `technicalMetadata.image_metadata.measurementFlare` (string)
    Example: "0.999%"

  - `technicalMetadata.image_metadata.measurementIlluminant` (string)
    Example: "D65"

  - `technicalMetadata.image_metadata.technology` (string)
    Example: "Cathode Ray Tube Display"

  - `technicalMetadata.image_metadata.redToneReproductionCurve` (string)
    Example: "(Binary data 2060 bytes, use -b option to extract)"

  - `technicalMetadata.image_metadata.greenToneReproductionCurve` (string)
    Example: "(Binary data 2060 bytes, use -b option to extract)"

  - `technicalMetadata.image_metadata.blueToneReproductionCurve` (string)
    Example: "(Binary data 2060 bytes, use -b option to extract)"

  - `technicalMetadata.image_metadata.imageWidth` (integer)
    Example: 3264

  - `technicalMetadata.image_metadata.imageHeight` (integer)
    Example: 4080

  - `technicalMetadata.image_metadata.encodingProcess` (string)
    Example: "Baseline DCT, Huffman coding"

  - `technicalMetadata.image_metadata.bitsPerSample` (number)
    Example: 8

  - `technicalMetadata.image_metadata.colorComponents` (integer)
    Example: 3

  - `technicalMetadata.image_metadata.yCbCrSubSampling` (string)
    Example: "YCbCr4:2:0 (2 2)"

  - `technicalMetadata.image_metadata.imageSize` (string)
    Example: "3264x4080"

  - `technicalMetadata.image_metadata.megapixels` (number)
    Example: 13.3

  - `presignedURL` (string)
    The URL to download the file. Populated for download requests.

  - `linkType` (string)

  - `relationshipId` (string)

  - `secondaryId` (string)

  - `versionNumber` (integer)
    Asset version number

## Response 401 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 403 fields (application/json):

  - `message` (string)

  - `detail` (string)