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:
TypeVariantsDescription
Vanillarelease, snapshotOfficial Minecraft server versions
Serverspaper, purpurPerformance-optimized server software
Moddedfabric, forge, neoforgeFrameworks for modded Minecraft servers
Bedrocklatest, previewBedrock edition server versions
ProxiesvelocityProxy 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)

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 /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

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 /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)

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

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

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

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:
CodeMeaning
200Success
400Bad Request / Missing Parameters
404Not Found
500Internal Server Error

For support or to report issues, join the Discord.

← Back to Downloads