REST API

API Documentation

Programmatic access to every server JAR on mcjarfiles.com — Vanilla, Paper, Purpur, Leaf, Folia, modded loaders, Bedrock, and proxies.

4 endpoints 8+ server types No auth required
01

Getting Started

Every endpoint is a plain HTTP GET request — no API key, token, or auth header required.

Base URL
All requests are made relative to this URL.
https://mcjarfiles.com/api

Try it now

https://mcjarfiles.com/api/get-latest-jar/servers/paper

Paste that URL into your browser — it redirects straight to the latest Paper server JAR.

02

Endpoints

Four GET endpoints cover every server type on the site. Jump to the full reference below for parameters and examples.

GET
/api/get-jar/{type}/{variant}/{version}

Downloads a specific Minecraft server JAR file for the given type, variant, and version.

GET
/api/get-latest-jar/{type}/{variant}

Downloads the newest available JAR file for the specified type and variant.

GET
/api/get-version-info/{type}/{variant}/{version}

Retrieves build, channel, and timestamp metadata for one specific version.

GET
/api/get-versions/{type}/{variant}

Lists every available version identifier for a type and variant, newest first.

03

Server Types & Variants

Pass type and variant as path segments — for example /servers/paper or /modded/fabric.

Vanilla
Official Minecraft server versions from Mojang
releasesnapshot
Servers
Performance-optimized server software
paperpurpurleafmcfolia
Modded
Frameworks for modded Minecraft servers
fabricforgeneoforge
Bedrock
Bedrock edition — requires an extra /windows or /linux path segment
latestpreview
Proxies
Proxy server software for network management
velocity
04

API Reference

Full path parameters, response codes, and examples for each endpoint.

GET/api/get-jar/{type}/{variant}/{version}
Downloads a specific Minecraft server JAR file for the given type, variant, and version.

Path Parameters

typerequiredOne of vanilla, servers, modded, bedrock, proxies
variantrequiredA valid variant for the selected type, e.g. paper or forge
versionrequiredA specific version, e.g. 1.21.8

Responses

200JAR file (application/java-archive)
400Invalid parameters
404Resource not found
500Server issue

Example Requests

GET https://mcjarfiles.com/api/get-jar/vanilla/release/1.21.1
GET https://mcjarfiles.com/api/get-jar/servers/leafmc/26.2
GET https://mcjarfiles.com/api/get-jar/bedrock/latest/windows/1.21.100.7
05

Response Codes

Every endpoint uses these HTTP status codes consistently.

200Success — request completed as expected
400Bad Request — missing or invalid parameters
404Not Found — check type, variant, or version
500Internal Server Error — try again shortly

Need help or found a bug?

Join the Discord for support, or head back and grab a JAR the easy way.

Join Discord← Back to Downloads