API Documentation

Welcome to the mcjarfiles.com API! This API provides easy access to Minecraft server JAR files and metadata for various server types, including Vanilla, modded servers, Bedrock, and proxies.

Getting Started

To use the mcjarfiles.com API, send HTTP GET requests to the endpoints listed below. No authentication is required, but ensure your requests include the correct parameters to avoid errors.

https://mcjarfiles.com/api

Endpoints Overview

The API offers four main endpoints to interact with Minecraft server data:

/get-jar

Download a specific JAR file for a given type and variant

Automate server setup with a specific version

/get-latest-jar

Download the latest JAR file for a type and variant

Quickly grab the newest Paper server JAR

/get-version-info

Retrieve metadata for a specific version

Check compatibility or release details

/get-versions

List all available versions for a type and variant

Display all available snapshot versions

Supported Types & Variants

The API supports different Minecraft server types, each with specific variants:

Type	Variants	Description
Vanilla	`release, snapshot`	Official Minecraft server versions
Servers	`paper, purpur`	Performance-optimized server software
Modded	`fabric, forge, neoforge`	Frameworks for modded Minecraft servers
Bedrock	`latest, preview (requires platform: /windows or /linux)`	Bedrock edition server versions - platform path required
Proxies	`velocity`	Proxy server software for network management

Endpoint Details

🔹 GET /api/get-jar/{type}/{variant}/[version]

Downloads a specific Minecraft server JAR file based on the provided type, variant, and version.

Path Parameters:

type (required): One of vanilla, servers, modded, bedrock, proxies
variant (required): A valid variant for the selected type
version (required): Specific version (e.g., 1.21.1)
Note for Bedrock: When type is bedrock, an additional path segment /windows or /linux is required after version (e.g., /bedrock/latest/windows/1.21.100.7).

Responses:

200 OK: JAR file (application/java-archive)
400 Bad Request: Invalid parameters
404 Not Found: Resource not found
500 Internal Server Error: Server issue

Example Request:

GET https://mcjarfiles.com/api/get-jar/vanilla/release/1.21.1

GET https://mcjarfiles.com/api/get-jar/bedrock/latest/windows/1.21.100.7

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

Fetches the latest available JAR file for the specified type and variant.

Path Parameters:

type (required): One of vanilla, servers, modded, bedrock, proxies
variant (required): A valid variant for the selected type
Note for Bedrock: When type is bedrock, an additional path segment /windows or /linux is required after variant (e.g., /bedrock/latest/windows).

Responses:

200 OK: JAR file (application/java-archive)
400 Bad Request: Invalid parameters
404 Not Found: Resource not found
500 Internal Server Error: Server issue

Example Request:

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

GET https://mcjarfiles.com/api/get-latest-jar/bedrock/latest/windows

🔹 GET /api/get-version-info/{type}/{variant}/[version]

Retrieves detailed metadata for a specific version of the given type and variant.

Path Parameters:

type (required): One of vanilla, servers, modded, bedrock, proxies
variant (required): A valid variant for the selected type
version (required): Specific version (e.g., 1.20.4)
Note for Bedrock: When type is bedrock, an additional path segment /windows or /linux is required between variant and version (e.g., /bedrock/latest/windows/1.21.100.7).

Responses:

200 OK: JSON metadata
400 Bad Request: Invalid parameters
404 Not Found: Version not found
500 Internal Server Error: Server issue

Example Request:

GET https://mcjarfiles.com/api/get-version-info/modded/forge/1.20.4

GET https://mcjarfiles.com/api/get-version-info/bedrock/latest/windows/1.21.100.7

Example Response:

[
  {
    "name": "forge-49.2.0",
    "minecraftVersion": "1.20.4",
    "time": 1741133640,
    "forgeVersion": "49.2.0"
  }
]

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

Lists all available version IDs for the specified type and variant.

Path Parameters:

type (required): One of vanilla, servers, modded, bedrock, proxies
variant (required): A valid variant for the selected type
Note for Bedrock: When type is bedrock, an additional path segment /windows or /linux is required after variant (e.g., /bedrock/latest/windows).

Responses:

200 OK: JSON array of versions
400 Bad Request: Invalid parameters
404 Not Found: No versions found
500 Internal Server Error: Server issue

Example Request:

GET https://mcjarfiles.com/api/get-versions/vanilla/snapshot

GET https://mcjarfiles.com/api/get-versions/bedrock/latest/windows

Example Response:

[
  "1.21.8-rc1",
  "1.21.7-rc2",
  "1.21.7-rc1",
  "1.21.6-rc1",
  "1.21.6-pre4",
  "1.21.6-pre3",
  "1.21.6-pre2",
  "1.21.6-pre1",
  "25w21a",
  "25w20a",
  "25w19a",
  "25w18a",
  "25w17a",
  "25w16a",
  "25w15a",
  "25w14craftmine",
  "1.21.5-rc2",
  "1.21.5-rc1",
  "1.21.5-pre3",
  "1.21.5-pre2",
  "1.21.5-pre1",
  "25w10a",
  "25w09b",
  "25w09a",
]

Response Codes

Common HTTP response codes for all endpoints:

Code	Meaning
200	Success
400	Bad Request / Missing Parameters
404	Not Found
500	Internal Server Error

For support or to report issues, join the Discord.

← Back to Downloads