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

api.minecraftvanilla.net

Primary Endpoint

/v1/versions

Routing

Supports id, target, type and query-based pagination.

Main Endpoint

Core

/v1/versions
Returns the paginated versions API.

Route Conventions

Paths

Clean 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, page and article=true still work on top of these routes.

Examples

Requests

List all versions

Returns every visible Minecraft version.

api.minecraftvanilla.net/v1/versions

Get one version by id

Returns one specific version by exact id.

api.minecraftvanilla.net/v1/versions/1.21.4

Filter by target

Returns all versions whose release target is 1.21.

api.minecraftvanilla.net/v1/versions/target/1.21

Filter by type

Returns every version with the given type.

api.minecraftvanilla.net/v1/versions/type/release

Filter by target and type

Combines release target and version type.

api.minecraftvanilla.net/v1/versions/target/1.21/type/release

Pagination

Returns paginated results.

api.minecraftvanilla.net/v1/versions?limit=10&page=2

Include article content

Adds changelog/article content to the response.

api.minecraftvanilla.net/v1/versions/1.21.4?article=true

Useful Query Parameters

Filters

id
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 for id and verTarget.

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.