Good news! Enterprise-scale distribution is now handled through the robust JFrog Platform.
Please contact us with any questions.

Skip to end of metadata
Go to start of metadata


Bintray exposes APIs with which users can automatically download package files, specified by their URLs, using different tools. Depending on the repository type, package type and other criteria, these may be build tools (such as Maven and Gradle), package management tools (such as Debian and RPM) and others (such as the HTTP client cURL). To download a file using APIs you need to specify the precise URL that corresponds to the file’s location within Bintray.

Files are stored in Bintray in a well-defined structure according to the repository and package in which they reside, as well as an additional Target Repository Path that the file’s owner can specify when doing the upload. A file’s URL is constructed as follows:


  • SUBJECT_NAME is the Bintray user or organization that owns the repository
  • USER_NAME is your Bintray user name and API_KEY is your Bintray API Key
    (USER_NAME and API_KEY are optional parameters and are only needed when you are doing an authenticated download)
  • REPO_NAME is the name of the repository in which the file is stored
  • FILE_PATH is the full path to the file you want to download
  • VERSION is the version of the package in which the artifact is stored

For example, to use cURL to download a file called: "myfile.jar", that was uploaded using a Target Repository Path of "acme/projectx/rel5", to a repository called "myrepo", by a user whose username is "john", you would use the following line of code:

curl -u <YOUR USER_NAME>:<YOUR API_KEY> -o /tmp/myfile.jar
Page Contents

Using "Set Me Up"

As a convenience, each repository and package offers a Set Me Up! button which displays a window showing download instructions for each tool relevant to the specific repository or package.
The example below shows a Set Me Up! window for a Maven repository. It includes instructions for download using the Maven client as well as general instructions in a line of cURL script that other tools can use:

Clicking the different options in this window displays instructions for the relevant procedure, with GUI screenshots or lines of code where necessary.

Downloading Files from Private Repositories  

If you have a package stored in a private repository, you need to include authentication credentials, your Bintray Username and your API Key, in the API call you use to download package files.

(Exception: If you are downloading the package using a Signed URL, just use the URL provided to you without adding authentication details - that’s the purpose of Signed URLs)

Downloading Unpublished Files 

If you are downloading an unpublished package from your own repository, you need to include authentication credentials, your Bintray Username and your API Key, in the API call you use to do the download. 

 For more details on how to download files using REST, please refer to Download Content in the Bintray REST API documentation.

Last updated 2017-09-26 07:47:42 +00:00
  • No labels