List all versions
Returns every visible Minecraft version.
API Documentation
JSON over HTTP
Minecraft Vanilla
Versions API
This root page documents the JSON endpoints exposed by this repository.
The main API lives under /v1/versions and supports exact lookups,
route-based filters and classic query parameters.
Base URL
Primary Endpoint
Routing
Main Endpoint
Core/v1/versions
Returns the paginated versions API.
Route Conventions
PathsClean routes are available for the most common lookups, while query parameters still handle pagination and optional flags.
/v1/versions/{id}
Targets one exact version id./v1/versions/target/{verTarget}
Filters by release target./v1/versions/type/{type}
Filters by type./v1/versions/target/{verTarget}/type/{type}
Combines both filters.- Query parameters
limit,pageandarticle=truestill work on top of these routes.
Examples
RequestsGet one version by id
Returns one specific version by exact id.
Filter by target
Returns all versions whose release target is 1.21.
Filter by type
Returns every version with the given type.
Filter by target and type
Combines release target and version type.
www.api.minecraftvanilla.net/v1/versions/target/1.21/type/release
Pagination
Returns paginated results.
Include article content
Adds changelog/article content to the response.
www.api.minecraftvanilla.net/v1/versions/1.21.4?article=true
Useful Query Parameters
Filtersid
One or more exact ids, comma-separated.verTarget
One or more release targets, comma-separated.type
One or more version types, comma-separated.limit
Page size.page
Page number starting at 1.article=true
Include changelog or article content.*wildcard
Can be used foridandverTarget.
Response Shape
Schema{
"page": 1,
"pages": 1,
"limit": 10,
"versionsFound": 42,
"latest": {
"release": "1.21.4",
"dev": "25w07a"
},
"versions": [
{
"id": "1.21.4",
"type": "release",
"releaseTarget": "1.21.4"
}
]
}
Exact fields vary depending on the endpoint and available database data.