Sign in
versions

Get multiple versions

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

environment'client_and_server' | 'client_only' | 'client_only_server_optional' | 'singleplayer_only' | 'server_only' | 'server_only_client_optional' | 'dedicated_server_only' | 'client_or_server' | 'client_or_server_prefers_both' | 'unknown' required

The environment a project or version supports. For an explanation of each environment, see the blog post here: https://modrinth.com/news/article/new-environments/#new-system

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",
    "environment": "client_and_server",
    "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"
      }
    ]
  }
]

Changes

Changed in 3 of the 21 revisions of this API.325

  • 16bb5dbc54f41See the full diff
    • ○

      added the required property items/allOf[subschema #2]/environment to the response with the 200 status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 0bffa67217e113See the full diff
    • ▲

      the items/allOf[subschema #2]/files/items/file_type response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ○

      added FileTypeEnum subschema #2 to the items/allOf[subschema #2]/files/items/file_type response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      removed the optional-resource-pack enum value from the items/allOf[subschema #2]/files/items/file_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the required-resource-pack enum value from the items/allOf[subschema #2]/files/items/file_type response property for the response status 200

      response-property-enum-value-removed

  • 3f6661cf21f2221See the full diff
    • ▲

      the response property items/allOf[subschema #2]/files/items/file_type became nullable for the status 200

      response-property-became-nullable

    • ▲

      the items/allOf[subschema #2]/files/items/file_type response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ●

      added the new optional-resource-pack enum value to the items/allOf[subschema #2]/files/items/file_type response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new required-resource-pack enum value to the items/allOf[subschema #2]/files/items/file_type response property for the response status 200

      response-property-enum-value-added

    • ○

      removed FileTypeEnum subschema #2 from the items/allOf[subschema #2]/files/items/file_type response property allOf list for the response status 200

      response-property-all-of-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog