# Download orders API

Use the Download orders API to create and retrieve download orders. A download order is a compressed file that contains media files, such as images, vectors, or videos.
## Authentication
To use the Download orders API, you need:
- The URL of your Content Hub server. You can get this from your Content Hub Administrator. Enter this URL in the <b>{{server}}</b> variable by hovering your mouse  over the variable in the <b>Try it</b> pane and then clicking <b>Edit</b>.
- An access token and the client ID. Both are sent with every request. You can create a token through the [Content Hub interface](https://doc.sitecore.com/ch/en/users/content-hub/create-an-oauth-client.html) or by [requesting one using the API itself](https://doc.sitecore.com/ch/en/developers/cloud-dev/oauth-tokens.html#making-requests)


Version: v1.0
License: closed source
Metadata:
  - product: Content Hub

## Servers

```
https://{server}
```

Variables:
- `server`
Default: "your-server"

## Security

### OAuth2

Type: oauth2

## Download OpenAPI description

[Download orders API](https://api-docs.sitecore.com/_bundle/ch/download-orders-api/index.yaml)

## Download orders

A download order is a compressed file that contains media files along with the download order configuration.

### Retrieve a download order with a specific ID

 - [GET /api/downloadorders/{id}](https://api-docs.sitecore.com/ch/download-orders-api/download-orders/downloadordersbyid.md): Retrieves a download order with a specific ID along with download details, such as the target count, whether the order has conversions, who created the order and when, as well as the download status.

### Retrieve multiple download orders

 - [GET /api/downloadorders](https://api-docs.sitecore.com/ch/download-orders-api/download-orders/downloadorders.md): Lists the download orders that the current user has access to.

### Create a download order

 - [POST /api/downloadorders](https://api-docs.sitecore.com/ch/download-orders-api/download-orders/adddownloadorders.md): Creates a download order for the specified assets using the defined download options.

### Retrieve a download order target

 - [GET /api/downloadorders/{orderId}/targets/{entityId}](https://api-docs.sitecore.com/ch/download-orders-api/download-orders/downloadordertargetsbyentityid.md): Retrieves a download order for the specified order and target ID.

### Retrieve the download order targets

 - [GET /api/downloadorders/{orderId}/targets](https://api-docs.sitecore.com/ch/download-orders-api/download-orders/downloadordertargets.md): Retrieves the download order targets for the specified order ID.