224% ROI and payback in under 3 months for Azul Zing.
Read Forrester’s Total Economic Impact™ Study.

Slash your Java support costs as much as 90%!
We make it easy, safe and secure.

Zulu OpenJDK Discovery API

The Zulu OpenJDK Discovery API helps utilize the OpenJDK builds provided by Azul Systems.

This API allows you to programmatically fetch lists of OpenJDK builds, detailed information about each build, and a way to download them.

Developer API documentation

API Endpoint Reference

The base URL for all REST endpoints is:

https://api.azul.com/zulu/download/community/v1.0


Current API version: 1.0

Bundle API Endpoints

List Endpoint

Route: /bundles/

Method: GET

Returns a list of bundle descriptions, sorted by OpenJDK version, then Zulu bundle version. You may use query parameters to limit the number of results returned by this request.

Download Bundle Binary Endpoints

Route: /bundles/<id>/binary/

Method: GET

Redirects the client to the download for the bundle with the given id.

Route: /bundles/sha256/<sha256checksum>/binary/

Method: GET

Redirects the client to the download for the bundle with the given sha256checksum.

Route: /bundles/latest/binary/

Method: GET

When using this endpoint query parameters should be used to ensure the bundle will match your requirements. This endpoint redirects the client to the download for the latest bundle that matches the query parameters.

Bundle Detail Endpoints

Route: /bundles/<id>/

Method: GET

Returns a single bundle description for the bundle with the given id.

Route: /bundles/sha256/<sha256checksum>/

Method: GET

Returns a single bundle description for the given sha256checksum, a Base64-encoded hash value that has a length of 64 bytes.

Route: /bundles/latest/

Method: GET

When using this endpoint query parameters should be used to ensure the bundle returned will match your requirements. This endpoint returns a single bundle description for the latest bundle that matches the query parameters.

API Usage Examples

You can test the API using the curl command. Note that as new bundles are added, the result of some of the example queries may change.

Jump to:

Request to list all available bundles

curl -H "Accept: application/json" "https://api.azul.com/zulu/download/community/v1.0/bundles/"

Response:

[
  {
    "id": 90,
    "name": "zulu1.6.0_42-6.2.0.9-x86lx64.zip",
    "url": "https://cdn.azul.com/zulu/bin/zulu1.6.0_42-6.2.0.9-x86lx64.zip",
    "jdk_version": [
      6,
      0,
      42,
      0
    ],
    "zulu_version": [
      6,
      2,
      0,
      9
    ]
  },
  {
    "id": 89,
    "name": "zulu1.6.0_42-6.2.0.9-x86lx64.rpm",
    "url": "https://cdn.azul.com/zulu/bin/zulu1.6.0_42-6.2.0.9-x86lx64.rpm",
    "jdk_version": [
      6,
      0,
      42,
      0
    ],
    "zulu_version": [
      6,
      2,
      0,
      9
    ]
  },
  {
    "id": 92,
    "name": "zulu1.6.0_47-6.3.0.3-win64.msi",
    "url": "https://cdn.azul.com/zulu/bin/zulu1.6.0_47-6.3.0.3-win64.msi",
    "jdk_version": [
      6,
      0,
      47,
      0
    ],
    "zulu_version": [
      6,
      3,
      0,
      3
    ]
  },
  ...
]

Request to list all the 64-bit OpenJDK 11 Linux builds in tar.gz format:

curl -H "Accept: application/json" "https://api.azul.com/zulu/download/community/v1.0/bundles/?jdk_version=11&ext=tar.gz&os=linux&arch=x86&hw_bitness=64"

Response:

[
   {
      "id":799,
      "name":"zulu11.2.3-jdk11.0.1-linux_x64.tar.gz",
      "url":"https://cdn.azul.com/zulu/bin/zulu11.2.3-jdk11.0.1-linux_x64.tar.gz",
      "jdk_version":[
         11,
         0,
         1,
         0
      ],
      "zulu_version":[
         11,
         2,
         3,
         0
      ]
   },
   {
      "id":828,
      "name":"zulu11.2.5-ca-fx-jdk11.0.1-linux_x64.tar.gz",
      "url":"https://cdn.azul.com/zulu/bin/zulu11.2.5-ca-fx-jdk11.0.1-linux_x64.tar.gz",
      "jdk_version":[
         11,
         0,
         1,
         0
      ],
      "zulu_version":[
         11,
         2,
         5,
         0
      ]
   },
   {
      "id":839,
      "name":"zulu11.29.3-ca-jdk11.0.2-linux_x64.tar.gz",
      "url":"https://cdn.azul.com/zulu/bin/zulu11.29.3-ca-jdk11.0.2-linux_x64.tar.gz",
      "jdk_version":[
         11,
         0,
         2,
         0
      ],
      "zulu_version":[
         11,
         29,
         3,
         0
      ]
   },
   ...
]

Request to list all bundles that include the JavaFX API:

curl -H "Accept: application/json" "https://api.azul.com/zulu/download/community/v1.0/bundles/?features=fx"

Response:

[
  {
    "id": 818,
    "name": "zulu8.33.0.1-ca-fx-jdk8.0.192-linux_x64.tar.gz",
    "url": "https://cdn.azul.com/zulu/bin/zulu8.33.0.1-ca-fx-jdk8.0.192-linux_x64.tar.gz",
    "jdk_version": [
      8,
      0,
      192,
      0
    ],
    "zulu_version": [
      8,
      33,
      0,
      1
    ]
  },
  {
    "id": 822,
    "name": "zulu8.33.0.1-ca-fx-jdk8.0.192-win_x64.zip",
    "url": "https://cdn.azul.com/zulu/bin/zulu8.33.0.1-ca-fx-jdk8.0.192-win_x64.zip",
    "jdk_version": [
      8,
      0,
      192,
      0
    ],
    "zulu_version": [
      8,
      33,
      0,
      1
    ]
  },
  {
    "id": 821,
    "name": "zulu8.33.0.1-ca-fx-jdk8.0.192-win_i686.zip",
    "url": "https://cdn.azul.com/zulu/bin/zulu8.33.0.1-ca-fx-jdk8.0.192-win_i686.zip",
    "jdk_version": [
      8,
      0,
      192,
      0
    ],
    "zulu_version": [
      8,
      33,
      0,
      1
    ]
  },
  ...
]

Request to show details of bundle 1152:

curl -H "Accept: application/json" "https://api.azul.com/zulu/download/community/v1.0/bundles/1152/"

Response:

{
  "id": 1152,
  "arch": "x86",
  "hw_bitness": "64",
  "os": "windows",
  "ext": "zip",
  "bundle_type": "jre",
  "last_modified": "2019-10-16T04:10:08Z",
  "url": "https://cdn.azul.com/zulu/bin/zulu13.28.11-ca-jre13.0.1-win_x64.zip",
  "name": "zulu13.28.11-ca-jre13.0.1-win_x64.zip",
  "zulu_version": [
    13,
    28,
    11,
    0
  ],
  "jdk_version": [
    13,
    0,
    1,
    0
  ],
  "size": 43352200,
  "md5_hash": "86527dcc1ec91edbc445c70be7cb0d5a",
  "sha256_hash": "7eba9fd0f8546280068a1103ebc704fc983780b87ac026bdd435e8a5237f5c58",
  "features": [
    "headfull"
  ]
}

Request to show details on the latest 64-bit OpenJDK 8 Linux build in tar.gz format:

curl -H "Accept: application/json" "https://api.azul.com/zulu/download/community/v1.0/bundles/latest/?jdk_version=8&ext=tar.gz&os=linux&arch=x86&hw_bitness=64"

Response:

{
   "id":1127,
   "arch":"x86",
   "hw_bitness":"64",
   "os":"linux",
   "ext":"tar.gz",
   "bundle_type":"jre",
   "last_modified":"2019-10-16T01:10:41Z",
   "url":"https://cdn.azul.com/zulu/bin/zulu8.42.0.21-ca-jre8.0.232-linux_x64.tar.gz",
   "name":"zulu8.42.0.21-ca-jre8.0.232-linux_x64.tar.gz",
   "zulu_version":[
      8,
      42,
      0,
      21
   ],
   "jdk_version":[
      8,
      0,
      232,
      0
   ],
   "size":42437100,
   "md5_hash":"e0e3a140a8e4a567c28d2c2be5581d34",
   "sha256_hash":"0824a61545f1397da82ebc54b781b186e96291e8dff7e32ddaf755fbc2f2a71e",
   "features":[
      "headfull"
   ]
}

Request to show details of bundle with SHA256 hash value

‘5cb5a08d10a270b5c642dc542626fa7880513a8374d029f55f07b733c735f6a1’:

curl -H "Accept: application/json" "https://api.azul.com/zulu/download/community/v1.0/bundles/sha256/5cb5a08d10a270b5c642dc542626fa7880513a8374d029f55f07b733c735f6a1/"

Response:

{
    "id": 11883,
    "url": "https://cdn.zulu.org/zulu/releases/zulu6.2.0.9-ca-jdk6.0.42-linux.x86_64.rpm",
    "arch": "x86",
    "abi": "any",
    "hw_bitness": "64",
    "os": "linux",
    "ext": "rpm",
    "bundle_type": "jdk",
    "release_status": "ga",
    "support_term": "sts",
    "last_modified": "2017-07-27T14:34:15Z",
    "name": "zulu6.2.0.9-ca-jdk6.0.42-linux.x86_64.rpm",
    "zulu_version": [
        6,
        2,
        0,
        9
    ],
    "jdk_version": [
        6,
        0,
        42,
        29
    ],
    "size": 54445200,
    "md5_hash": "9b60628201e26e5f2c4073e46982e2bd",
    "sha256_hash": "5cb5a08d10a270b5c642dc542626fa7880513a8374d029f55f07b733c735f6a1",
    "javafx": false,
    "features": [
        "jdk"
    ]
}

Request to download the latest 64-bit OpenJDK 8 Linux build in tar.gz format:

curl -LJO "https://api.azul.com/zulu/download/community/v1.0/bundles/latest/binary/?jdk_version=8&ext=tar.gz&os=linux&arch=x86&hw_bitness=64"

© Azul 2020 All rights reserved.