Tags & Loaders

Get available tags including loaders, game versions, categories, and licenses

Overview

The tags API provides access to all available metadata tags used throughout Modrinth, including loaders, game versions, categories, licenses, and more.

Get Available Games

GET /v3/games

Returns a list of all supported games on Modrinth.

Response

games · array

Array of game objects.

Show Game Object

slug · string

The unique identifier for the game

Example: minecraft

name · string

Display name of the game

Example: Minecraft

icon · string

URL to the game icon

banner · string

URL to the game banner image

Example

curl "https://api.modrinth.com/v3/games"

Get Loaders

GET /v3/tag/loader

Returns a list of all available loaders (Fabric, Forge, Quilt, NeoForge, etc.).

Response

loaders · array

Array of loader objects.

Show Loader Object

name · string

The loader name/identifier

Example: fabric, forge, quilt, neoforge

icon · string

SVG icon for the loader

supported_project_types · string[]

Array of project types this loader supports

Example: ["mod", "modpack"]

supported_games · string[]

Array of game slugs this loader supports

Example: ["minecraft"]

supported_fields · string[]

Array of loader field names available for this loader

Example: ["game_versions", "environment"]

metadata · object

Additional metadata about the loader

Example

curl "https://api.modrinth.com/v3/tag/loader"

Get Categories

GET /v3/tag/category

Returns all available project categories.

Response

categories · array

Array of category objects.

Show Category Object

name · string

The category identifier

Example: adventure, technology, optimization

icon · string

SVG icon for the category

project_type · string

The project type this category belongs to

Example: mod, modpack, resourcepack

header · string

Display header for the category

Example: Categories, Resolutions

Example

curl "https://api.modrinth.com/v3/tag/category"

Get Loader Fields

GET /v3/loader_field

Returns enumerable values for a specific loader field (like game versions).

Query Parameters

loader_field · string · required

The name of the loader field to get values for.

Common fields:

• game_versions - Available game versions
• environment - Environment types
• singleplayer - Singleplayer support
• client_and_server - Client/server support

Example: game_versions

filters · object

Optional filters to apply to the field values as JSON object.

For game versions, you can filter by:

• type - Version type (release, snapshot, beta, alpha)
• major - Boolean for major versions only

Example: {"type": "release", "major": true}

Response

values · array

Array of loader field value objects.

Show Loader Field Value

value · string

The field value

Example: 1.20.1, 1.19.4

created · string

RFC 3339 timestamp when this value was created

metadata · object

Additional metadata about this value

For game versions:

• type - Version type (release, snapshot, etc.)
• major - Boolean indicating if this is a major version

Examples

Get All Game Versions

curl "https://api.modrinth.com/v3/loader_field?loader_field=game_versions"

Get Major Release Versions Only

curl "https://api.modrinth.com/v3/loader_field?loader_field=game_versions&filters=%7B%22type%22%3A%22release%22%2C%22major%22%3Atrue%7D"

Get Licenses

GET /v3/license

Returns all SPDX license identifiers.

Response

licenses · array

Array of license objects.

Show License Object

short · string

SPDX license identifier

Example: MIT, GPL-3.0, Apache-2.0

name · string

Full license name

Example: MIT License, GNU General Public License v3.0

Example

curl "https://api.modrinth.com/v3/license"

Get License Text

GET /v3/license/{id}

Returns the full text of a specific license.

Path Parameters

id · string · required

SPDX license identifier or special identifier.

Use ARR for the default “All Rights Reserved” license.

Example: MIT, GPL-3.0, ARR

Response

title · string

License title

body · string

Full license text

Example

curl "https://api.modrinth.com/v3/license/MIT"

Get Link Platforms

GET /v3/link_platform

Returns all available link platforms (for project links and donation platforms).

Response

platforms · array

Array of platform objects.

Show Platform Object

name · string

Platform identifier

Example: github, discord, patreon

donation · boolean

Whether this platform is for donations

Example

curl "https://api.modrinth.com/v3/link_platform"

Get Report Types

GET /v3/report_type

Returns all available report types for content moderation.

Response

report_types · string[]

Array of report type identifiers

Example

curl "https://api.modrinth.com/v3/report_type"

Get Project Types

GET /v3/project_type

Returns all available project types.

Response

project_types · string[]

Array of project type identifiers

Common values: mod, modpack, resourcepack, shader, datapack, plugin

Example

curl "https://api.modrinth.com/v3/project_type"

Caching

All tag endpoints are heavily cached using Redis. Results are cached for extended periods as tag data rarely changes. You can safely cache these responses on the client side as well.

Common Use Cases

Building a Mod Browser

1. Fetch available loaders with GET /v3/tag/loader
2. Get game versions with GET /v3/loader_field?loader_field=game_versions
3. Fetch categories with GET /v3/tag/category
4. Use these to build filter UI for search

Version Compatibility Checking

1. Get loader field values for game_versions
2. Filter by version type if needed
3. Cross-reference with project version requirements

License Validation

1. Fetch all licenses with GET /v3/license
2. Validate user input against SPDX identifiers
3. Optionally display full license text with GET /v3/license/{id}