Genus Media Upshot API: How to get the Status of a File using jQuery Ajax


Genus Media Upshot API allows to know the status of a file (documents, videos, images, etc..) so you can perform an action depending on the status received. Here's one easy way to do it with an asynchronous HTTP (Ajax) request using jQuery.

There is no a link to Genus documentation.

API Request Details


Content-Type: application/json; charset=utf-8





Note: the {file-id} must be the ID of the resource you are looking for .



Status Code: 200 OK
Possible status

Uploaded | Processing | Ready | Error Processing | Not Available


The list above is not the complete list of all the possible statuses that can be received, I share only the different statuses that I have received from different calls that I have done to the API until now, more statuses can be obtained, so be careful of how you use the previous list on your code.

Example Response

  "value" : "",
  "uuid" : "22f01-8b-45-a7-b494de",
  "name" : "Ready",
  "display-name" : "Ready",
  "need-update" : false
Example using jQuery

    url : "",
    type : "GET",
    async : true,
    contentType : "application/json; charset=utf-8",
    statusCode : {
        200 : function(json) {
            if ( == "Ready") {
                // do something
                // show a message

Note:  console.log() can throw errors in IE, they are there for illustrative purposes only and should be changed as required.

About the author

Enterprise Web Developer
Joaquin is an Enterprise Web Developer at Base22 with over seven years of experience designing and developing web solutions for enterprise clients. He is a well rounded web developer with skills building interfaces in IBM WebSphere Portal and WCM, IBM Connections, and many others. He is an Oracle Certified Java Developer and a Microsoft Certified Visual Studio Developer. He blogs at