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.
When Are Asset Versions Created?
Asset versions are created only when:
- An asset is trimmed, or
- An asset is replaced
Note
Renditions do not count as versions and should be ignored when reviewing version data.
API Endpoint
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
Required Parameters
- api_token – Your Cincopa account API token
- rid – The Asset ID you want to inspect
Replace:
- {your_token} with your actual API token
- {your_asset_id} with the asset’s ID
How to Identify Asset Versions
- Run the API call for a specific asset.
- Review the response payload.
- Locate the attached_versions section.
- Ignore all entries except those labeled ver-X (for example, ver-1, ver-2).
Sample JSON Response
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
}
How to Interpret Results
- Focus only on attached_versions.
- Ignore the renditions section.
- If no ver-X entries exist, the asset has no additional versions.
- If one or more ver-X entries exist, the asset has multiple versions.
These ver-X entries represent versions created through trimming or replacement.