Downloads

The download endpoints are used to retrieve information about downloads and initiate downloads. It is an OAuth endpoint and therefore expects proper OAuth headers/parameters to be sent to it.

View Downloads

This endpoint allows the calling application to view various things in the user’s download library.

GET /order/1/downloads

Required Parameters:

• status (string): Either one of available, re-download, or downloaded. These status filters correspond to the three sections of the download library on Beatport.

Optional Parameters:

• page (integer): Which page of the resultset to view.
• perPage (integer): How many results per page should be returned.

Initiate Downloads

This endpoint allows the client application to “initiate” a download. Beatport will mark this download as initiated and provide a link to the download.

POST /order/1/downloads

Required Parameters:

• downloadIds (list): A list of download ids to initiate downloads for. The download id for each piece of content is given by the view downloads api.

Optional Parameters:

none

Initiate Promo Download

This endpoint allows the client application to “initiate” a promo download. This is used for the downloading of free tracks by a user.

POST /order/1/promo-downloads

Required Parameters:

• trackId (integer): The track id to download as a promo download. This only works with tracks that have a saleType of promotion.

Optional Parameters:

none