Developers

API and data access

Everything on this site is synced from public APIs and served back as one. This is that data as a free JSON API: keyless, open to any origin, and cached, so you can build on it directly from a browser or a server.

No key

Read endpoints need no token and no sign-up. Be gentle and cache; there is no hard quota, only good manners.

CORS open

Every response sends Access-Control-Allow-Origin: *, so a browser on any site can call it without a proxy.

Attribution

Free to use. A link back to mcreference.com is appreciated, and the underlying data belongs to each upstream publisher.

Endpoints

Base URL: mcreference.com. Everything is GET and returns JSON.

GET/api/v1/versions
Every Minecraft version, newest first, ordered by Mojang's manifest position.
Query: type, era, limit (up to 200), offset
/api/v1/versions?type=RELEASE&limit=5 ↗
GET/api/v1/versions/{slug}
One version in full: Java requirement, protocol, data version, jar URLs and checksums.
Query: none
/api/v1/versions/26.2 ↗
GET/api/v1/software
Server software, proxies, loaders and launchers with build and version counts.
Query: type (SERVER_SOFTWARE | PROXY | MOD_LOADER | LAUNCHER)
/api/v1/software?type=SERVER_SOFTWARE ↗
GET/api/v1/java
Java runtimes, whether each is LTS, and how many Minecraft releases target it.
Query: none
/api/v1/java ↗
GET/api/v1/projects
The catalogue: mods, plugins, modpacks, packs and shaders, filtered and paged.
Query: type (required), gameVersion, loader, category, edition, sort, page
/api/v1/projects?type=MOD&gameVersion=26.2&loader=fabric ↗

Feeds

An Atom feed of new Minecraft versions, for a reader, a bot or a webhook: /feed.xml. It updates the moment a release or snapshot is synced.

Example

# Which Java version does the latest release need?
curl -s https://mcreference.com/api/v1/versions/26.2 | jq '.data.javaMajor'
# 25

# Every Fabric mod that supports 26.2, most downloaded first
curl -s "https://mcreference.com/api/v1/projects?type=MOD&gameVersion=26.2&loader=fabric" | jq '.data[].name'

This is v1 and stable. Breaking changes would ship under a new version prefix, never on top of this one.