Sign in

v19

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-037759134.1 KB
versions

List project's versions

get/project/{id|slug}/version

Query parameters

loadersstring
Example:["fabric"]

The types of loaders to filter for

game_versionsstring
Example:["1.18.1"]

The game versions to filter for

featuredboolean

Allows to filter for featured or non-featured versions only

include_changelogboolean

Allows you to toggle the inclusion of the changelog field in the response. It is highly recommended to use include_changelog=false in most cases unless you specifically need the changelog for all versions.

Response

Expected response to a valid request

namestring required

The name of this version

version_numberstring required

The version number. Ideally will follow semantic versioning

changelogstring nullable

The changelog for this version

game_versionsstring[] required

A list of versions of Minecraft that this version supports

version_type'release' | 'beta' | 'alpha' required

The release channel for this version

loadersstring[] required

The mod loaders that this version supports. In case of resource packs, use "minecraft"

featuredboolean required

Whether the version is featured or not

status'listed' | 'archived' | 'draft' | 'unlisted' | 'scheduled' | 'unknown'
requested_status'listed' | 'archived' | 'draft' | 'unlisted' nullable
idstring required

The ID of the version, encoded as a base62 string

project_idstring required

The ID of the project this version is for

author_idstring required

The ID of the author who published this version

date_publishedstring ISO-8601 required
downloadsinteger required

The number of times this version has been downloaded

changelog_urlstring nullable

A link to the changelog for this version. Always null, only kept for legacy compatibility.

Example response

[
  {
    "name": "Version 1.0.0",
    "version_number": "1.0.0",
    "changelog": "List of changes in this version: ...",
    "dependencies": [
      {
        "version_id": "IIJJKKLL",
        "project_id": "QQRRSSTT",
        "file_name": "sodium-fabric-mc1.19-0.4.2+build.16.jar",
        "dependency_type": "required"
      }
    ],
    "game_versions": [
      "1.16.5",
      "1.17.1"
    ],
    "version_type": "release",
    "loaders": [
      "fabric",
      "forge",
      "minecraft"
    ],
    "featured": true,
    "status": "listed",
    "id": "IIJJKKLL",
    "project_id": "AABBCCDD",
    "author_id": "EEFFGGHH",
    "files": [
      {
        "hashes": {
          "sha512": "93ecf5fe02914fb53d94aa3d28c1fb562e23985f8e4d48b9038422798618761fe208a31ca9b723667a4e05de0d91a3f86bcd8d018f6a686c39550e21b198d96f",
          "sha1": "c84dd4b3580c02b79958a0590afd5783d80ef504"
        },
        "url": "https://cdn.modrinth.com/data/AABBCCDD/versions/1.0.0/my_file.jar",
        "filename": "my_file.jar",
        "size": 1097270,
        "file_type": "required-resource-pack"
      }
    ]
  }
]