Home » API Reference » Jobs » List Jobs

permalink List Jobs

GET https://app.zencoder.com/api/v2/jobs.json?api_key=asdf1234

Required

More Information

A list of jobs can be obtained by sending an HTTP GET request to https://app.zencoder.com/api/v2/jobs?api_key=93h630j1dsyshjef620qlkavnmzui3 (replace the api_key with your own). It will return an array of jobs similar to the example below. The list of thumbnails will be empty until the job is completed. By default, the results are paginated with 50 jobs per page and sorted by ID in descending order. You can pass two parameters to control the paging: page and per_page. per_page has a limit of 50.

    [{
      "job": {
        "created_at": "2010-01-01T00:00:00Z",
        "finished_at": "2010-01-01T00:00:00Z",
        "updated_at": "2010-01-01T00:00:00Z",
        "submitted_at": "2010-01-01T00:00:00Z",
        "pass_through": null,
        "id": 1,
        "input_media_file": {
          "format": "mpeg4",
          "created_at": "2010-01-01T00:00:00Z",
          "frame_rate": 29,
          "finished_at": "2010-01-01T00:00:00Z",
          "updated_at": "2010-01-01T00:00:00Z",
          "duration_in_ms": 24883,
          "audio_sample_rate": 48000,
          "url": "s3://bucket/test.mp4",
          "id": 1,
          "error_message": null,
          "error_class": null,
          "audio_bitrate_in_kbps": 95,
          "audio_codec": "aac",
          "height": 352,
          "file_size_bytes": 1862748,
          "video_codec": "h264",
          "test": false,
          "total_bitrate_in_kbps": 593,
          "channels": "2",
          "width": 624,
          "video_bitrate_in_kbps": 498,
          "state": "finished"
        },
        "test": false,
        "output_media_files": [{
          "format": "mpeg4",
          "created_at": "2010-01-01T00:00:00Z",
          "frame_rate": 29,
          "finished_at": "2010-01-01T00:00:00Z",
          "updated_at": "2010-01-01T00:00:00Z",
          "duration_in_ms": 24883,
          "audio_sample_rate": 44100,
          "url": "http://s3.amazonaws.com/bucket/video.mp4",
          "id": 1,
          "error_message": null,
          "error_class": null,
          "audio_bitrate_in_kbps": 92,
          "audio_codec": "aac",
          "height": 352,
          "file_size_bytes": 1386663,
          "video_codec": "h264",
          "test": false,
          "total_bitrate_in_kbps": 443,
          "channels": "2",
          "width": 624,
          "video_bitrate_in_kbps": 351,
          "state": "finished",
          "label": "Web"
        }],
        "thumbnails": [{
          "created_at": "2010-01-01T00:00:00Z",
          "updated_at": "2010-01-01T00:00:00Z",
          "url": "http://s3.amazonaws.com/bucket/video/frame_0000.png",
          "id": 1
        }],
        "state": "finished"
      }
    }]
  
    
      
        2010-06-23T22:37:49Z
        
        3529
        
        waiting
        2010-06-23T22:37:49Z
        false
        2010-06-23T22:37:49Z
        
          128
          aac
          48000
          2
          2010-06-23T22:37:49Z
          60000
          
          
          8209138
          
          mp4
          23
          272
          4451
          waiting
          false
          957
          2010-06-23T22:37:49Z
          http://example.com/files/1234/matrix.mov
          829
          h.264
          640
        
        
        
      
      
        2010-06-23T22:37:49Z
        
        3527
        
        waiting
        2010-06-23T22:37:49Z
        false
        2010-06-23T22:37:49Z
        
          128
          aac
          48000
          2
          2010-06-23T22:37:49Z
          60000
          
          
          8209138
          
          mp4
          23
          272
          4448
          waiting
          false
          957
          2010-06-23T22:37:49Z
          http://example.com/files/1234/matrixy.mov
          829
          h.264
          640
        
        
        
      
    
  

Job states include pending, waiting, processing, finished, failed, and cancelled.

Input states include pending, waiting, processing, finished, failed, and cancelled.

Output states include waiting, queued, assigning, processing, finished, failed, cancelled and no input.