API Endpoints

Version Details API

API endpoint to get detailed information about a specific Magma version

Version Details API

Get detailed information about a specific Magma version.

Endpoint

GET /api/versions/{version}

Path Parameters

ParameterDescription
versionThe specific version string (e.g., "21.1.33-beta", "20.1.0")

Response

{
  "groupId": "org.magmafoundation",
  "artifactId": "magma",
  "version": "21.1.33-beta",
  "minecraftVersion": "1.21.x",
  "downloadUrl": "https://repo.magmafoundation.org/releases/org/magmafoundation/magma/21.1.33-beta/magma-21.1.33-beta.jar",
  "installerUrl": "https://repo.magmafoundation.org/releases/org/magmafoundation/magma/21.1.33-beta/magma-21.1.33-beta-installer.jar",
  "changelogUrl": "https://repo.magmafoundation.org/releases/org/magmafoundation/magma/21.1.33-beta/magma-21.1.33-beta-changelog.txt",
  "isStable": false,
  "hasServerJar": true,
  "hasInstaller": true,
  "hasChangelog": true,
  "fileSize": "36.25 MB",
  "releaseDate": "2025-04-15"
}

Response Fields

The response includes all fields from the version list endpoint, plus:

FieldTypeDescription
hasServerJarbooleanWhether the server JAR file is available
hasInstallerbooleanWhether the installer JAR file is available
hasChangelogbooleanWhether the changelog file is available
fileSizestringHuman-readable size of the installer (or JAR if installer unavailable)
releaseDatestringRelease date in YYYY-MM-DD format

Error Responses

Status CodeDescription
400Bad Request - Missing or invalid version parameter
404Not Found - The requested version was not found
500Server Error - Failed to fetch version details

On this page