/videos/conversions/list

List conversions for a given video.

Parameters

video_key : string

Key of the video which conversions to list.

result_limit (optional): unsigned integer

Specifies maximum number of video conversions to return. Default is 50. Maximum result limit is 1000.

result_offset (optional): unsigned integer

Specifies how many video conversions should be skipped at the beginning of the result set. Default is 0.

Example response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <limit>50</limit>
  <offset>0</offset>
  <total>2</total>
  <conversions total="2">
    <conversion key="SjwIOMZV">
      <duration>12.00</duration>
      <filesize>639173</filesize>
      <height>180</height>
      <link>
        <protocol>http</protocol>
        <address>cdn.jwplayer.com</address>
        <path>/originals/BvbnBjB6.mp4</path>
      </link>
      <mediatype>video</mediatype>
      <status>Ready</status>
      <template key="zYEm0xvS">
        <format key="original">
          <name>Original</name>
        </format>
        <name>Original</name>
        <required>True</required>
      </template>
      <width>320</width>
    </conversion>
    <conversion key="8TpN3mQu">
      <duration>12.00</duration>
      <filesize>548206</filesize>
      <height>180</height>
      <link>
        <protocol>http</protocol>
        <address>cdn.jwplayer.com</address>
        <path>/videos/BvbnBjB6-k8YcW1QY.mp4</path>
      </link>
      <mediatype>video</mediatype>
      <status>Ready</status>
      <template key="k8YcW1QY">
        <format key="mp4">
          <name>H.264 Baseline</name>
        </format>
        <required>True</required>
        <name>H.264 Web</name>
      </template>
      <width>320</width>
    </conversion>
    <conversion key="2QiN3RGz">
      <duration>12.00</duration>
      <error id="2">
        <message>Moving the encoded file to its final destination failed.</message>
      </error>
      <filesize>748206</filesize>
      <height>180</height>
      <mediatype>video</mediatype>
      <status>Failed</status>
      <template key="V7uAuJ3l">
        <format key="mp4">
          <name>H.264 Baseline</name>
        </format>
        <name>H.264 TV</name>
        <required>False</required>
      </template>
      <width>320</width>
    </conversion>
    ...
  </conversions>
</response>

Response parameters

/response/status : string

Call execution status. Set to ok if call executed successfully.

/response/limit : unsigned integer

Maximum number of video conversions that should be return. As specified in the result_limit request parameter.

/response/offset : unsigned integer

Number of video conversions that should be skipped at the beginning of the result set. As specified in the result_offset request parameter.

/response/total : unsigned integer

Total number of conversions this video has.

/response/conversions/@total : string

Total number of returned video conversions.

//conversion/mediatype : string

Conversion media type:

audio

Conversion media type is audio.

video

Conversion media type is video.

//conversion/status : string

Conversion status:

Queued

Conversion is being transcoded.

Ready

Conversion is ready and can be streamed.

Failed

Failed to encode or upload the conversion.

//conversion/duration : float

Duration of the conversion in seconds. Set to -1 if conversion duration in unknown.

//conversion/filesize : unsigned integer

Size of the conversion in bytes. Set to -1 if conversion file size in unknown.

//conversion/width : unsigned integer

Conversion width. Set to -1 if conversion width in unknown.

//conversion/height : unsigned integer

Conversion height. Set to -1 if conversion height in unknown.

//conversion/template/@key : string

Key of the conversion template.

//conversion/template/name : string

Name of the conversion template.

//conversion/template/required : string

True if conversion template is a required template, False otherwise.

//conversion/template/format/@key : string

Key of the video format used for this template:

mp4

H.264 video and AAC audio in MP4 container.

aac

AAC audio in MP4 container.

mp3

MP3 audio.

passthrough

Passthrough format.

original

Original unmodified video or audio.

ogg (DEPRECATED)

Theora video and Vorbis audio in Ogg container.

webm (DEPRECATED)

VP8 video and Vorbis audio in WebM container.

vorbis (DEPRECATED)

Vorbis audio in Ogg container.

flv (DEPRECATED)

H.263 video and MP3 audio in Flash Video container.

See the list of supported output formats for more information.

//conversion/template/format/name : string

Name of the video format used for this template.

//conversion/error : string

Conversion error. Included in response only when conversion status is Failed.

//conversion/error/message : string

Conversion error message.

//conversion/link : string

Conversion download link split into 3 parts: protocol, address and path. Included in response only when conversion status is Ready.

//conversion/link/protocol : string

Protocol part of the conversion download link.

//conversion/link/address : string

Address part of the conversion download link.

//conversion/link/path : string

Path part of the conversion download link.