API v1 is deprecated and will be turned off on January 1, 2022. Check out the API v2 documentation.

Our Conversion rypes API allows to identify which formats we do support and which options are possible.

Get possible conversion types

Calling /conversiontypes will return all possible conversion types and possible options. Both query parameters inputformat and outputformat are optional. The mode query parameter defaults to convert.

GET https://api.cloudconvert.com/v1/conversiontypes?inputformat=mp4&outputformat=mp3
[
    {
        "inputformat": "mp4",
        "outputformat": "mp3",
        "converter": "ffmpeg",
        "converteroptions": {
            "audio_codec": "MP3",
            "audio_bitrate": "128",
            "audio_channels": null,
            "audio_frequency": null,
            "trim_from": null,
            "trim_to": null,
            "audio_normalize": null
        }
    }
]
            

converteroptions shows all possible options and their default values for this conversion. These options can be specified at the start of a conversion. To find out possible values please use the API Console.

Get all possible input formats

GET https://api.cloudconvert.com/v1/inputformats
[
  {
    "inputformat": "7z",
    "group": "archive"
  },
  {
    "inputformat": "ace",
    "group": "archive"
  },

...

]

The possible output formats for one specific input format can be determined using the /conversiontypes?inputformat= API as stated above.

Get all possible output formats

GET https://api.cloudconvert.com/v1/outputformats
[
  {
    "outputformat": "7z",
    "group": "archive"
  },
  {
    "outputformat": "rar",
    "group": "archive"
  },

...

]

The possible input formats for one specific output format can be determined using the /conversiontypes?outputformat= API as stated above.