Skip to main content

​
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.

​
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.

​
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.

​
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.

​
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.

​
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 /v3/link_platform
Returns all available link platforms (for project links and donation platforms).

​
Response

​
platforms
array
Array of platform objects.

​
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 identifiersCommon 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

  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
  1. Get loader field values for game_versions
  2. Filter by version type if needed
  3. Cross-reference with project version requirements
  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}