Get Asset

Retrieve an Asset's details and metadata by specifying an Object ID or File ID in the request path.

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

Average Response Time: 451ms (Get asset by fileId)

Average Response Time: 2973ms (Get asset by objectId)

SecurityApiKeyAuth or BasicAuth

Request

path Parameters

required

string <uuid> = 36 characters

Asset Object ID or File ID

header Parameters

X-API-Key required	string Customer-specific API key required to invoke API.
Authorization required	string Provided by Authentication Token creation operation
AccessToken required	string JWT token provided by Authentication Token creation operation.

Responses

200

Returns JSON object

401

Unauthorized. Missing Authorization or AccessToken or expired token

403

returns JSON object with error description.

get/asset/{id}

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"createdBy": "7d675ef0-f423-11e9-8071-89c0c405214e",
"createdEpoch": 1608745510614,
"currentVersion": "Y",
"customerId": "123203455",
"fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc",
"filename": "adventure-alps-beautiful-landscape-2444403.jpg",
"fileState": "available",
"lastUpdatedBy": "7d675ef0-f423-11e9-8071-89c0c40133ds",
"lastUpdatedEpoch": 1612333543954,
"metadata": [{"metadataDefinitionId": "dfeb57c1-b149-4b15-920f-3f40ff0b959a",
"metadataDefinitionValue": "Photo"
}
],
"metadataDenormalized": { },
"metadataState": "available",
"metadataTemplateId": "ea6eb24d-adef-4380-bd02-f64f567c437f",
"objectId": "e6f4bd5e-9bea-43cb-b15e-22582fa5322e",
"objectType": "Asset",
"originalFileId": "003391e4-e78a-4186-b2d7-b5d4fcbe445d",
"renditions": {"width": 1920,
"height": 1080,
"imageThumb": "https://env.content.tenovos.io/1588091945181/445c273a-235f-4d3b-8397-567f02f312e0/35c8cc9b-0aab-43aa-b220-7829f821836a-200x200.png",
"imagePreview": "https://env.content.tenovos.io/1588091945181/445c273a-235f-4d3b-8397-567f02f312e0/35c8cc9b-0aab-43aa-b220-7829f821836a-700x700.png",
"imagePreviewLarge": "https://env.content.tenovos.io/1588091945181/445c273a-235f-4d3b-8397-567f02f312e0/35c8cc9b-0aab-43aa-b220-7829f821836a-1000x1000.png",
"mezzaninePreview": "https://env.content.tenovos.io/1588091945181/445c273a-235f-4d3b-8397-567f02f312e0/gilfoyle_anton-3000x3000.png",
"imagePreviewExtraLarge": "https://env.content.tenovos.io/1588091945181/445c273a-235f-4d3b-8397-567f02f312e0/35c8cc9b-0aab-43aa-b220-7829f821836a-5000x5000.png"
},
"securityTemplateIds": ["7d6f4e30-f423-11e9-8071-89c0c4052156"
],
"securityDenormalized": [{"groupId": "7d6207c0-f423-11e9-8071-89c0c4052141",
"permissions": ["d0bbfb23-9304-4eb0-9c60-8e6e27a580d9"
]
}
],
"technicalMetadata": {"tenovos_metadata": {"fileName": "adventure-alps-beautiful-landscape-2444403.jpg",
"fileSize": "4.4 MB",
"MD5Checksum": "6cbc612262877e8502904ea3ffd6a278"
},
"image_metadata": {"fileName": "adventure-alps-beautiful-landscape-2444403.jpg",
"fileSize": "4.4 MB",
"fileType": "JPEG",
"fileTypeExtension": "jpg",
"mimeType": "image/jpeg",
"jfifVersion": "1.01",
"resolutionUnit": "inches",
"xResolution": "72",
"yResolution": "72",
"profileCMMType": "Linotronic",
"profileVersion": "2.1.0",
"profileClass": "Display Device Profile",
"colorSpaceData": "RGB",
"profileConnectionSpace": "XYZ",
"profileDateTime": "1998:02:09 06:49:00",
"profileFileSignature": "acsp",
"primaryPlatform": "Microsoft Corporation",
"cmmFlags": "Not Embedded, Independent",
"deviceManufacturer": "Hewlett-Packard",
"deviceModel": "sRGB",
"deviceAttributes": "Reflective, Glossy, Positive, Color",
"renderingIntent": "Perceptual",
"connectionSpaceIlluminant": "0.9642 1 0.82491",
"profileCreator": "Hewlett-Packard",
"profileID": "0",
"profileCopyright": "Copyright (c) 1998 Hewlett-Packard Company",
"profileDescription": "sRGB IEC61966-2.1",
"mediaWhitePoint": "0.95045 1 1.08905",
"mediaBlackPoint": "0 0 0",
"redMatrixColumn": "0.43607 0.22249 0.01392",
"greenMatrixColumn": "0.38515 0.71687 0.09708",
"blueMatrixColumn": "0.14307 0.06061 0.7141",
"deviceMfgDesc": "IEC http://www.iec.ch",
"deviceModelDesc": "IEC 61966-2.1 Default RGB color space - sRGB",
"viewingCondDesc": "Reference Viewing Condition in IEC61966-2.1",
"viewingCondIlluminant": "19.6445 20.3718 16.8089",
"viewingCondSurround": "3.92889 4.07439 3.36179",
"viewingCondIlluminantType": "D50",
"luminance": "76.03647 80 87.12462",
"measurementObserver": "CIE 1931",
"measurementBacking": "0 0 0",
"measurementGeometry": "Unknown",
"measurementFlare": "0.999%",
"measurementIlluminant": "D65",
"technology": "Cathode Ray Tube Display",
"redToneReproductionCurve": "(Binary data 2060 bytes, use -b option to extract)",
"greenToneReproductionCurve": "(Binary data 2060 bytes, use -b option to extract)",
"blueToneReproductionCurve": "(Binary data 2060 bytes, use -b option to extract)",
"imageWidth": 3264,
"imageHeight": 4080,
"encodingProcess": "Baseline DCT, Huffman coding",
"bitsPerSample": 8,
"colorComponents": 3,
"yCbCrSubSampling": "YCbCr4:2:0 (2 2)",
"imageSize": "3264x4080",
"megapixels": 13.3
}
},
"versionNumber": 0,
"presignedURL": "string",
"linkType": "string",
"relationshipId": "928dd5b8-3ead-4528-bdef-9c0b867a5d7d",
"secondaryId": "string"
}