Home » API Reference » Outputs » Output Progress

permalink Output Progress

GET https://app.zencoder.com/api/v2/outputs/1234/progress.json?api_key=asdf1234

GET https://app.zencoder.com/api/v2/outputs/1234/progress.xml?api_key=asdf1234

GET https://app.zencoder.com/api/v2/outputs/1234/progress.js?api_key=asdf1234&callback=asdf


Required

Optional


More Information

Api V2 and later

The return will contain one or more of the following keys: state, current_event, current_event_progress and progress.

    {
      "state": "processing",
      "current_event": "Transcoding",
      "current_event_progress": 45.32525,
      "progress": 32.34567345
    }
  
    
      processing
      Transcoding
      45.32525
      32.34567345
    
  

The current_event_progress number is the percent complete of the current event – so if the event is Transcoding, and current_event_progress is 99.3421, then the file is almost finished transcoding, but hasn't started Uploading yet. The progress number is the overall percentage of completion for the output.

Api V1 and earlier

The return will contain one or more of the following keys: state, current_event, and progress.

    {
      "state": "processing",
      "current_event": "Transcoding",
      "progress": 32.34567345
    }
  
    
      processing
      Transcoding
      32.34567345
    
  

The progress number is the percent complete of the current event – so if the event is Transcoding, and progress is 99.3421, then the file is almost finished transcoding, but hasn't started Uploading yet.

Valid states include: waiting, queued, assigning, processing, finished, failed, cancelled, no input, and skipped.

Events include: downloading, transcoding and uploading.

If you're getting a 404 to a Job Progress request, make sure that you're using the output ID, not the job ID, and make sure your API key is correct. A 404 means that we didn't find an output file with the specified ID for the account linked to the provided API key.

JSONP Requests

For AJAX and other public requests, Read Only API Keys can access this information using JSONP by requesting the URL with a .js extension. The response will use the progress callback unless one is specified using the callback in the querystring.

    progress(
      {
        "state": "processing",
        "current_event": "Downloading",
        "progress": "32.34567345"
      }
    )