v13

latestOpenAPI 3.0.0raw.githubusercontent.com2023-04-201625158.8 KB
Outputs

Get Output Details

Get details for a job output. Job details are available for two months after the job is submitted.

get/outputs/{output_id}

Path parameters

output_idinteger required

A Zencoder job output id

Query parameters

pageinteger

The page of results to return

per_pageinteger

The number of results to return for each page

Headers

Content-Typestring required

Content-Type: application/json

Zencoder-Api-Keystring required

Your API key

Response

Output properties.

audio_bitrate_in_kbpsinteger

Audio bitrate of the output media file

audio_codecstring

Audio codec of the output media file

audio_sample_rateinteger

Audio sample rate of the output media file

channelsinteger

The number of audio channels in the output media file

created_atstring

ISO 8601 date-time string representing when the output file was created

updated_atstring

ISO 8601 date-time string representing when state of processing on the output file last changed

finished_atstring

ISO 8601 date-time string representing when processing the output file finished

duration_in_msinteger

Duration in ms of the output media file

error_classstring

The type of error thrown if an error occurred in processing the output file

error_messagestring

The error message thrown if an error occurred in processing the output file

file_size_bytesinteger

The file size in bytes of the output file

fragment_duration_in_msinteger

Duration of final fragment for segmented types

formatstring

The format of the output file

frame_rateinteger

The frame_rate of the output file

heightinteger

The frame height of the output file in pixels

idinteger

The id of the output file, an integer in the 64-bit range.

labelstring

Label for the output

md5_checksuminteger

The checksum of the output file

privacyboolean

Privacy mode

rfc_6381_audio_codecstring

Audio codec for industry compatibility

rfc_6381_video_codecstring

Video codec for industry compatibility

statestring

The current state of the file:

  • pending (not yet submitted to Zencoder)
  • submitting (currently submitting to Zencoder)
  • transcoding (currently transcoding)
  • uploading (currently uploading the output file)
  • finished (Zencoder finished processing the file)
  • failed (Zencoder was unable to process the file)
testboolean

Test mode

video_bitrate_in_kbpsinteger

video bitrate of the output file

video_codecstring

video codec of the output file

widthinteger

frame width of the output file in pixels

total_bitrate_in_kbpsinteger

total audio+video bitrate of the output file

urlstring

URL of the output file

Example response

{
  "audio_bitrate_in_kbps": 90,
  "audio_codec": "aac",
  "audio_sample_rate": 44100,
  "channels": 2,
  "created_at": "2017-04-20T16:08:02Z",
  "updated_at": "2017-04-20T16:08:02Z",
  "finished_at": "2017-04-20T16:08:02Z",
  "duration_in_ms": 51312,
  "error_class": "InvalidAudioSettingsError",
  "error_message": "The supplied audio encoding settings were not valid",
  "file_size_bytes": 922620,
  "fragment_duration_in_ms": 5478,
  "format": "mpeg4",
  "frame_rate": 30,
  "height": 360,
  "id": 365495537,
  "label": "mp4 high",
  "privacy": true,
  "rfc_6381_audio_codec": "avc1.42001e",
  "rfc_6381_video_codec": "mp4a.40.2",
  "test": true,
  "video_bitrate_in_kbps": 1402,
  "video_codec": "h264",
  "width": 640,
  "total_bitrate_in_kbps": 7906,
  "url": "s3://zencodertesting/test.mov"
}