Server Jar JSON API

Free, public REST API for every jar indexed on this site. No API key, no auth, CORS enabled — build panels, launchers or update scripts on top of it.

Base URL

https://mcjarhub.com/api/v1

All responses are JSON with a success flag and a data payload. Errors use proper HTTP status codes (404, 400) and an error message. Responses are cacheable for 5 minutes.

  • Machine-readable spec: OpenAPI 3.1 (also linked from /.well-known/api-catalog).
  • Free and keyless, CORS *. Fair use: cache responses, send a descriptive User-Agent, don't poll more than necessary — clients that hammer the API may be rate-limited.
  • Attribution appreciated ("data from MCJarHub" with a link) — not required.
  • "latest" means the newest release with a stable build; add ?channel=experimental to include experimental builds.
  • Every version includes its source (official or mirror) and checksums (sha256, sha1, md5) where known.
  • Coming from ServerJars? The old /api/fetchJar, fetchLatest, fetchAll, fetchDetails and fetchTypes routes work here — details.
GET /api/v1/types

List all server types

Returns every available server software with version counts and links.

Try it curl "https://mcjarhub.com/api/v1/types"
GET /api/v1/types/{type}

Server type details

Details for one server type including its latest version.

Try it curl "https://mcjarhub.com/api/v1/types/paper"
GET /api/v1/types/{type}/versions

List versions

All versions of a server type, newest first. Optional query parameters: ?limit=25, ?channel=release|snapshot.

Try it curl "https://mcjarhub.com/api/v1/types/paper/versions?limit=5"
GET /api/v1/types/{type}/versions/{version}

Version details

Metadata for one specific version: build, size, Java requirement, release date and download links.

Try it curl "https://mcjarhub.com/api/v1/types/paper/versions/1.21.8"
GET /api/v1/types/{type}/versions/{version}/download

Download a jar

Responds with a 302 redirect to the jar file and counts the download. Works with curl -LO and wget.

Try it curl "https://mcjarhub.com/api/v1/types/paper/versions/1.21.8/download"
GET /api/v1/latest/{type}

Latest version

Shortcut for the newest version of a server type.

Try it curl "https://mcjarhub.com/api/v1/latest/vanilla"
GET /api/v1/search?q={query}

Search versions

Search across all versions. Optional &type={slug} to restrict to one software.

Try it curl "https://mcjarhub.com/api/v1/search?q=1.21&type=purpur"
GET /api/v1/types/{type}/versions/{version}/builds

Build history

The newest ~20 builds of a version with date, channel, checksums and upstream commit messages (Paper, Folia, Velocity, Waterfall, Purpur).

Try it curl "https://mcjarhub.com/api/v1/types/paper/versions/1.21.11/builds"
GET /api/v1/lookup?sha256={hash}

Identify a jar by checksum

Which software, version and build is this file? Accepts sha256, sha1 or md5.

Try it curl "https://mcjarhub.com/api/v1/lookup?sha256=5ffef465eeeb5f2a3c23a24419d97c51afd7dbb4923ff42df9a3f58bba1ccfba"
GET /api/v1/minecraft/{version}

Minecraft version info

Mojang release date, required Java, vanilla server SHA-1 and which server software supports the version.

Try it curl "https://mcjarhub.com/api/v1/minecraft/26.3"
GET /api/v1/badge/{type}

README badge (shields.io)

A shields.io endpoint: ![Paper](https://img.shields.io/endpoint?url=https://mcjarhub.com/api/v1/badge/paper) shows the latest stable version.

Try it curl "https://mcjarhub.com/api/v1/badge/paper"
GET /api/v1/stats

Instance statistics

Global counters: server types, versions indexed and downloads served.

Try it curl "https://mcjarhub.com/api/v1/stats"

Example: always run the newest Paper

#!/usr/bin/env bash
# newest stable Paper build, verified against its SHA-256
JSON=$(curl -s -A "my-updater/1.0" https://mcjarhub.com/api/v1/latest/paper)
curl -L -o paper.jar "$(echo "$JSON" | jq -r '.data.links.download')"
echo "$(echo "$JSON" | jq -r '.data.sha256')  paper.jar" | sha256sum -c - && java -Xms4G -Xmx4G -jar paper.jar nogui