# Operations

> List all possible operations, formats, engines and possible options.

## List operations

List all possible operations, formats, engines and possible options.

<api-endpoint endpoint="operations" method="GET">

[https://api.cloudconvert.com/v2/operations](https://api.cloudconvert.com/v2/operations)

</api-endpoint>

#### Query Parameters

<field-group>
<field name="filter[operation]" type="string">

The result will be filtered to include only possible operations with a matching operation name (e.g. `convert` or `optimize`).

</field>

<field name="filter[input_format]" type="string">

The result will be filtered to include only possible conversions with a matching input format.

</field>

<field name="filter[output_format]" type="string">

The result will be filtered to include only possible conversions with a matching output format.

</field>

<field name="filter[engine]" type="string">

Filter result to only include conversions with a matching engine name.

</field>

<field name="filter[engine_version]" type="string">

Filter result to only include conversions with a matching engine version.

</field>

<field name="alternatives" type="boolean">

For some formats multiple alternative engines are available. If set to `true`, the result includes these alternative conversion types. Defaults to `false`.

</field>

<field name="include" type="array">

Include `options` and/or `engine_versions` in the result. Use `options.details` to get the options including details for building user interfaces, such as labels, value ranges and descriptions of the possible values. We recommend to set `options,options.details` in this case.

</field>
</field-group>

#### Response

The list of possible conversion types:

<field-group>
<field name="operation" type="string">

Name of the operation, such as `convert`, `optimize` or `capture-website`.

</field>

<field name="input_format" type="string">

Format of the input file.

</field>

<field name="output_format" type="string">

Format of the conversion result.

</field>

<field name="engine" type="string">

Name of the engine.

</field>

<field name="credits" type="integer">

The base amount of conversion credits this operation consumes.

</field>

<field name="options" type="array">

Possible options for this conversion type. Available, if the include argument contains `options`.

<collapsible className="mb-0" close-text="Hide child attributes" open-text="Show child attributes">
<field-group>
<field name="name" type="string">

Name of the option.

</field>

<field name="type" type="string">

Data type of the option: `string`, `boolean`, `integer`, `float`, `enum` or `dictionary`.

</field>

<field name="default" type="string">

Default value.

</field>

<field name="description" type="string">

Description of the option.

</field>

<field name="possible_values" type="array">

Possible values if the data type is `enum`.

</field>

<field name="label" type="string">

Human-readable name of the option. Only available, if the include argument contains `options.details`. This applies to all following attributes as well. All of them are optional and more attributes might be added in the future.

</field>

<field name="group" type="string">

Category of the option, such as `video`, `audio` or `watermark`.

</field>

<field name="advanced" type="boolean">

`true` for rarely needed options. User interfaces might hide them by default.

</field>

<field name="depends_on" type="array">

The option only has an effect if all of these conditions are met. Each condition has a list of `options` and either `in` (any of the options has one of these values), `not_in` (none of the options has one of these values), `set: true` (any of the options is set) or `set: false` (none of the options is set, as they override this option). Unset options count with their default value. This is a recommendation for user interfaces and is not enforced when creating tasks.

</field>

<field name="min" type="number">

Recommended minimum value for `integer` and `float` options. `min`, `max` and `step` are recommendations for user interfaces and are not enforced when creating tasks.

</field>

<field name="max" type="number">

Recommended maximum value.

</field>

<field name="step" type="number">

Recommended step size.

</field>

<field name="unit" type="string">

Unit of the value, such as `px`, `%` or `dpi`.

</field>

<field name="marks" type="array">

Notable values of `integer` and `float` options. Each mark has a `value` and a `label`.

</field>

<field name="suggestions" type="array">

Common values of `string` options. Other values are allowed as well.

</field>

<field name="values" type="array">

Details about the `possible_values` of `enum` options. Each entry has a `value` and optionally a `label` and a `description`.

</field>
</field-group>
</collapsible>
</field>

<field name="engine_versions" type="array">

Compatible engine versions for this conversion type. Available, if the include argument contains `engine_versions`.

<collapsible className="mb-0" close-text="Hide child attributes" open-text="Show child attributes">
<field-group>
<field name="version" type="string">

Version of the engine.

</field>

<field name="default" type="boolean">

This is the default version.

</field>

<field name="latest" type="boolean">

This version is the latest one.

</field>

<field name="deprecated" type="boolean">

This version is deprecated.

</field>

<field name="experimental" type="boolean">

This version is experimental.

</field>
</field-group>
</collapsible>
</field>

<field name="deprecated" type="boolean">

This format is deprecated.

</field>

<field name="experimental" type="boolean">

This format is experimental.

</field>

<field name="meta" type="dictionary">

Meta attributes.

</field>
</field-group>
