Learn more about How to Retrieve Asset Versions Programmatically Using the Cincopa API in Cincopa.
Cincopa allows you to programmatically retrieve information about asset versions using the API. This is useful if you need to audit assets, manage storage, or identify videos that have multiple versions created through trimming or replacement.
This article explains how to retrieve a list of asset versions and how to interpret the results.
Asset versions are created only when:
[ht_message mstyle="info" title="Note" show_icon="true" id="" class="" style="" ]Renditions do not count as versions and should be ignored when reviewing version data.[/ht_message]
To retrieve asset version information, use the following API call:
https://api.cincopa.com/v2/asset.list.json?api_token={your_token}&rid={your_asset_id}&details=caption,description,music_tags,exif_tags,long_description,related_link_text,related_link_url,reference_id,tags,metauser_timeline,appears_in_albums,storyboard,attached,attached_versions
Replace:
Below is an example of an API response showing an asset with multiple versions:
{
"success": true,
"items": [
{
"id": "ASSET_INTERNAL_ID",
"rid": "ASSET_RID",
"type": "video",
"modified": "YYYY-MM-DDTHH:MM:SSZ",
"uploaded": "YYYY-MM-DDTHH:MM:SSZ",
"storage": "STORAGE_SIZE",
"claimed": "CLAIMED_SIZE",
"syncstatus": "synced",
"filename": "sample_video_file.mp4",
"caption": "Sample Caption",
"description": "Sample description",
"long_description": "",
"filesize": 123456789,
"related_link_text": "",
"related_link_url": "SAMPLE_URL",
"reference_id": "",
"tags": ",sample,example,",
"attributes": null,
"uploaded_by": "USER_ID,User Name",
"versions": {
"jpg_1200x900": {
"filesize": "12345",
"name": "1200x900",
"url": "SAMPLE_IMAGE_URL",
"mime": "image/jpeg"
},
"original": {
"name": "original",
"filesize": 123456789,
"mime": "video/mp4",
"url": "SAMPLE_VIDEO_URL"
},
"mp4_hd": {
"filesize": "987654321",
"name": "hd",
"url": "SAMPLE_VIDEO_URL",
"mime": "video/mp4"
}
},
"attached": [
{
"id": "ATTACHED_ID",
"rid": "ATTACHED_RID",
"type": "ver-1",
"filename": "sample_trimmed_video.mp4",
"caption": null,
"asset_type": null,
"attached_type": null,
"description": null,
"filesize": null,
"content": {
"type": "video/mp4",
"url": "SAMPLE_VIDEO_URL",
"syncstatus": "synced"
},
"versions": {
"original": {
"name": "original",
"filesize": 123456789,
"mime": "video/mp4",
"url": "SAMPLE_VIDEO_URL"
}
}
},
{
"id": "ATTACHED_ID",
"rid": "ATTACHED_RID",
"type": "original",
"filename": "sample_original_video.mp4",
"caption": null,
"asset_type": null,
"attached_type": null,
"description": null,
"filesize": null,
"content": {
"type": "video/mp4",
"url": "SAMPLE_VIDEO_URL",
"syncstatus": "synced"
},
"versions": {
"original": {
"name": "original",
"filesize": 123456789,
"mime": "video/mp4",
"url": "SAMPLE_VIDEO_URL"
}
}
}
],
"in_folders_list": [
{
"fid": "FOLDER_ID",
"did": "FOLDER_RID",
"name": "Sample Folder Name"
}
],
"content": {
"syncstatus": "synced",
"type": "video/mp4",
"url": "SAMPLE_VIDEO_URL"
},
"thumbnail": {
"syncstatus": "synced",
"type": "image/jpeg",
"url": "SAMPLE_IMAGE_URL"
},
"storyboard": {
"syncstatus": "synced",
"type": "image/jpeg",
"url": "SAMPLE_IMAGE_URL"
},
"timeline": {},
"exif": {
"height": "HEIGHT",
"width": "WIDTH",
"duration": "HH:MM:SS",
"fps": "FPS",
"bitrate": "BITRATE"
}
}
],
"items_data": {
"page": 1,
"items_per_page": 50,
"items_count": 1,
"pages_count": 1
},
"runtime": 123
}
These ver-X entries represent versions created through trimming or replacement.