|⚠️ Please note, the API is in an early Alpha version and is still a subject to change.|
Azul Community OpenJDK Builds API for Zulu allows you to utilize Community builds provided by Azul Systems.
This document refers to API version: v1.
API Endpoint Reference
The base URL for REST endpoints is:
The API consists of the following REST endpoints:
List Endpoint (
Returns a list of bundle descriptions sorted by an OpenJDK version and a Zulu bundle version. The format of the bundle description and a list of query parameters are given below.
Detail Endpoint (
Returns a single bundle description with a given id.
Binary Endpoint (
Redirects the client to the bundle file with a given id.
Bundle Description Format
A bundle description is a JSON structure that consists of the following fields:
|int or string||Surrogate primary key. Can be replaced with a special |
latest keyword (see below)
|string||Bundle file name|
|int||Version of the OpenJDK being built|
|string||Target CPU architecture (see “Query Parameters)”|
|string||Target operating system (see “Query Parameters)”|
|string||Bundle file extension (see “Query Parameters)”|
|string||Last modification timestamp in the ISO 8601 format|
|string||Full URL of the bundle|
|int||Zulu version. Consists of major, medium, minor version components and the build numbers of the Zulu bundle.|
|int||File size in bytes|
|string||MD5 digest of the bundle contents|
Fields marked with * display only in the detail view. Other fields display in both list and detail views.
NOTE: New fields can be added to the bundle description without affecting the API version.
Query parameters are intended for results filtering. They should be applied to:
- The List endpoint − at any time;
- The Detail and Binary endpoints − when the
latest keyword is used (see below).
Filters query results by the version of the OpenJDK in the format of 3 numbers separated by dots: major version, minor version, and revision (i.e., semantic versioning).
Numbers can be omitted starting with the revision. The omitted number corresponds to all values.
Filters query results by the operating system that the bundle targets.
linux − Linux, GLib
linux_musl − Linux, Musl
mac − MacOS X
win − Windows
solaris − Solaris
Filters query results by the CPU architecture the bundle is built for.
x86 − 32-bit PC (IA32)
x64 − 64-bit PC (AMD64 or EM64T)
sparcv9 − SPARC V9
Filters query results by the extension of the bundle file.
When id is replaced with this keyword, the endpoint returns a bundle with the latest OpenJDK version considering the current query parameters.
|⚠️ There is a limit of 100 API calls per hour per IP. When an API call is throttled, the value of |
Retry-After in the response header is useful to determine the time after which the API is expected to be available again.
1. List Bundles
Request to list all the 64-bit OpenJDK 9 Linux builds in the tar.gz format:
"jdk_version": [9, 0, 0]
"jdk_version": [9, 0, 1]
"jdk_version": [9, 0, 4]
"jdk_version": [9, 0, 7]
2. Retrieve Bundle Details
Request to show details of the latest 64-bit OpenJDK 8 Linux build in the tar.gz format:
"zulu_version": [8, 38, 0, 13],
"jdk_version": [8, 0, 212],