Versions List API

The Versions List API provides access to the latest Magma server software versions from the official Maven repository.

Endpoint

GET /api/versions

Query Parameters

Parameter	Type	Default	Description
`limit`	number	10	Number of versions to return. Set to 0 for all versions.

Response

{
  "total": 35,
  "limit": 10,
  "versions": [
    {
      "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
    }
  ]
}

Response Fields

Field	Type	Description
`total`	number	Total number of versions available in the repository
`limit`	number	The current limit applied to the results
`versions`	array	Array of version objects

Each version object contains:

Field	Type	Description
`groupId`	string	The Maven group ID (always "org.magmafoundation")
`artifactId`	string	The Maven artifact ID (always "magma")
`version`	string	The version string
`minecraftVersion`	string	The Minecraft version this build supports
`downloadUrl`	string	Direct download URL for the JAR file
`installerUrl`	string	Direct download URL for the installer JAR file
`changelogUrl`	string	URL to the changelog text file
`isStable`	boolean	Indicates if this is a stable release (not a beta/alpha/snapshot)

Versions List API

Versions List API

Endpoint

Query Parameters

Response

Response Fields

On this page