Modrinth
App · 19 actions
Search Modrinth for Minecraft mods, modpacks, resource packs, shaders, plugins, data packs and servers by loader, Minecraft version and category. Read a project's versions, files, dependencies and team, identify mod files by their hash and check them for updates, and look up users. A trigger runs a workflow when a project publishes a new version. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Check a project exists | Check whether a Modrinth project has this slug or ID, and get its ID. |
| Check files for updates | Check mod files for newer versions, from their hashes, up to 100 at a time: for each, the version it is, the newest version that fits the loaders, Minecraft versions and release channels given, and whether that is an update, with its download link. |
| Get a project | Get everything about one Modrinth project: its summary and full description page, type, categories, loaders, Minecraft versions, downloads and followers, licence, links to its source, issues, wiki and Discord, donation links and gallery. |
| Get a project's dependencies | Find what a project needs to run, and what it refuses to run with: each project its versions name, whether it is required, optional, shipped inside or incompatible, and in how many versions. |
| Get a user | Get a Modrinth user's public profile: username, bio, profile picture, role and when they joined. |
| Get a version | Get one version by its ID: its changelog, files with download links and hashes, loaders, Minecraft versions and dependencies. |
| Get a version by its number | Get a project's version by the version number its authors gave it, such as '0.5.11', with its changelog, files, download links and dependencies. |
| Get licence text | Get the full text of a standard licence by its SPDX ID, such as a project's 'MIT' or 'LGPL-3.0-only'. |
| Get random projects | Get projects picked at random from all of Modrinth, for a 'discover something new' post or a varied sample. |
| Get several projects | Get up to 100 Modrinth projects in one step, by slug or ID, with their downloads, followers, loaders, licence and last update. |
| Get statistics | Get how many projects, versions, files and authors Modrinth holds, for tracking the platform's growth. |
| Identify files by hash | Find which project and version each mod file belongs to, from its SHA-1 or SHA-512 hash, up to 100 at a time. |
| List a project's team | List the people on a project's team with their roles, such as Owner or Maintainer. |
| List a project's versions | List a project's versions, newest first, with their files, download links, hashes, loaders, Minecraft versions and dependencies. |
| List a user's projects | List the projects a Modrinth user publishes, most downloaded first, with their downloads added up. |
| List categories | List the categories projects are filed under on Modrinth, such as Optimization, Worldgen or 16x, with the project type each belongs to. |
| List loaders | List the loaders and platforms Modrinth knows, such as Fabric, NeoForge, Paper or Iris, with the project types each is used for. |
| List Minecraft versions | List Minecraft versions, newest first, with the date each came out: releases by default, or snapshots, old betas and alphas. |
| Search projects | Find Minecraft mods, modpacks, resource packs, shaders, plugins, data packs and servers on Modrinth by name or words, narrowed by type, category, loader, Minecraft version, whether it runs in the player's game or on a server, and open source. |
Check a project exists
Check whether a Modrinth project has this slug or ID, and get its ID. A slug nobody uses comes back with 'found' set to false rather than failing the step. No API key required.
Inputs
- Project
projecttextRequired - The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
Outputs
foundtrue/false- Whether a project has that slug or ID.
idtext- The project's ID, when it exists.
searched_fortext- The slug or ID that was checked.
urltext- The project's page on modrinth.com, when it exists.
Example output
{
"found": true,
"id": "AANobbMI",
"searched_for": "sodium",
"url": "https://modrinth.com/project/AANobbMI"
}Check files for updates
Check mod files for newer versions, from their hashes, up to 100 at a time: for each, the version it is, the newest version that fits the loaders, Minecraft versions and release channels given, and whether that is an update, with its download link. Give the loader and Minecraft version you play to stay on them. No API key required.
Inputs
- File hashes
hasheslistRequired - The SHA-1 or SHA-512 hash of each file, up to 100. Both kinds can be mixed: which is which is read from its length. Launchers and modpack files (modrinth.index.json) list these for every mod.
- Loaders
loaderslist - Only updates for these loaders, such as Fabric. Leave empty for any loader, which may offer a version for a different loader.
- Minecraft versions
game_versionslist - Only updates for these Minecraft versions. Leave empty to allow any, including newer Minecraft versions.
- Release channels
version_typeslist - Only updates in these channels, such as Release alone to skip betas. Leave empty for any channel.One or more of:
release,beta,alpha.
Outputs
countnumber- How many hashes were checked.
fileslist- One answer per hash, in the order given.
not_found_countnumber- How many hashes Modrinth doesn't know.
update_countnumber- How many files have a newer version.
Example output
{
"count": 2,
"files": [
{
"algorithm": "sha1",
"current_version_id": "SMxNOGZ6",
"current_version_number": "mc1.21.1-0.8.13-fabric",
"found": true,
"hash": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
"latest_date_published": "2026-09-15T15:57:23.369305Z",
"latest_download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/bAZQdGpg/sodium-fabric-0.9.2%2Bmc26.3.jar",
"latest_file_name": "sodium-fabric-0.9.2+mc26.3.jar",
"latest_found": true,
"latest_game_versions": [
"26.3"
],
"latest_loaders": [
"fabric"
],
"latest_sha1": "9acfe851e36f4fb27d7c5baa224e8bd4e0334283",
"latest_url": "https://modrinth.com/project/AANobbMI/version/bAZQdGpg",
"latest_version_id": "bAZQdGpg",
"latest_version_number": "mc26.3-0.9.2-fabric",
"latest_version_type": "release",
"project_id": "AANobbMI",
"project_title": "Sodium",
"update_available": true
},
{
"algorithm": "sha1",
"current_version_id": null,
"current_version_number": null,
"found": false,
"hash": "0000000000000000000000000000000000000000",
"latest_date_published": null,
"latest_download_url": null,
"latest_file_name": null,
"latest_found": false,
"latest_game_versions": [],
"latest_loaders": [],
"latest_sha1": null,
"latest_url": null,
"latest_version_id": null,
"latest_version_number": null,
"latest_version_type": null,
"project_id": null,
"project_title": null,
"update_available": false
}
],
"not_found_count": 1,
"update_count": 1
}Get a project
Get everything about one Modrinth project: its summary and full description page, type, categories, loaders, Minecraft versions, downloads and followers, licence, links to its source, issues, wiki and Discord, donation links and gallery. No API key required.
Inputs
- Project
projecttextRequired - The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
Outputs
bodytext- The project's full description page, written in Markdown.
categorieslist- The categories it is filed under, such as 'optimization'.
client_sidetext- Whether players need it installed: 'required', 'optional' or 'unsupported' (or 'unknown'). A mod that is 'unsupported' on the server only needs installing by players.
descriptiontext- The project's one-line summary.
discord_urltext- Its Discord invite, when given.
donation_urlslist- Where to support its authors.
downloadsnumber- How many times its files have been downloaded.
followersnumber- How many Modrinth users follow it.
gallerylist- Its gallery images.
game_versionslist- Every Minecraft version it has a file for, oldest first.
icon_urltext- The address of its icon image.
idtext- The project's ID, such as 'AANobbMI'. It never changes.
issues_urltext- Where to report bugs, when given.
license_idtext- Its licence's SPDX ID, such as 'MIT', or a 'LicenseRef-' ID for a licence of its own.
license_nametext- Its licence's full name, or its ID when Modrinth has none.
license_urltext- A link to its licence text, when the project gives one.
loaderslist- The loaders it runs on, such as 'fabric' or 'neoforge'.
organization_idtext- The ID of the organization that owns it, when one does.
project_typetext- What it is: mod, modpack, resourcepack, shader, plugin, datapack or minecraft_java_server.
publishedtext- When it was first published, as an ISO 8601 date and time.
server_sidetext- Whether a server needs it installed: 'required', 'optional' or 'unsupported' (or 'unknown'). A mod that is 'unsupported' on the server only needs installing by players.
slugtext- The project's slug, the readable name in its address, such as 'sodium'. Every action that takes a project accepts it.
source_urltext- Where its source code is, when given.
statustext- Its status on Modrinth, normally 'approved'.
team_idtext- The ID of the team that maintains it.
titletext- The project's name, such as 'Sodium'.
updatedtext- When it last changed, as an ISO 8601 date and time.
urltext- Its page on modrinth.com.
wiki_urltext- Its wiki or documentation, when given.
Example output
{
"body": "## Installation\n\nYou can find a guide to installation [here](https://github.com/IrisShaders/Iris/blob/multiloader-new/docs/guide.md).",
"categories": [
"decoration",
"optimization"
],
"client_side": "required",
"description": "A modern shader pack loader for Minecraft intended to be compatible with existing OptiFine shader packs",
"discord_url": "https://discord.gg/jQJnav2jPu",
"donation_urls": [
{
"platform": "Patreon",
"url": "https://www.patreon.com/ims21"
}
],
"downloads": 194678462,
"followers": 30170,
"gallery": [
{
"description": "Complementary Shaders 4.4 dev5",
"featured": false,
"title": "A nice sunset",
"url": "https://cdn.modrinth.com/data/YL57xq9U/images/17f09a3d424d6e2005fcecc81838780a6847f8ce_350.webp"
}
],
"game_versions": [
"26.1.2",
"26.2",
"26.3"
],
"icon_url": "https://cdn.modrinth.com/data/YL57xq9U/18d0e7f076d3d6ed5bedd472b853909aac5da202_96.webp",
"id": "YL57xq9U",
"issues_url": "https://github.com/IrisShaders/Iris/issues",
"license_id": "LGPL-3.0-only",
"license_name": "GNU Lesser General Public License v3.0 only",
"license_url": null,
"loaders": [
"fabric",
"neoforge",
"quilt"
],
"organization_id": null,
"project_type": "mod",
"published": "2021-05-27T05:11:15.690120Z",
"server_side": "unsupported",
"slug": "iris",
"source_url": "https://github.com/IrisShaders/Iris",
"status": "approved",
"team_id": "1HMZl6Mn",
"title": "Iris Shaders",
"updated": "2026-09-30T02:58:24.095409Z",
"url": "https://modrinth.com/mod/iris",
"wiki_url": null
}Get a project's dependencies
Find what a project needs to run, and what it refuses to run with: each project its versions name, whether it is required, optional, shipped inside or incompatible, and in how many versions. Narrow to a loader and Minecraft version for the exact answer for one setup. No API key required.
Inputs
- Project
projecttextRequired - The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
- Loaders
loaderslist - Only versions for these loaders, such as Fabric or NeoForge. Any one of them is enough. Leave empty for every loader.
- Minecraft versions
game_versionslist - Only versions for these Minecraft versions. Any one of them is enough. The list offers release versions; type a snapshot such as '26.4-snapshot-4' to use one. Leave empty for every Minecraft version.
Outputs
countnumber- How many projects are named.
dependencieslist- Each project its versions name, required ones first.
external_fileslist- Files from outside Modrinth that versions name.
projecttext- The project whose versions were read.
required_countnumber- How many of them are required.
versions_checkednumber- How many of its versions were read: the ones matching the filters.
Example output
{
"count": 1,
"dependencies": [
{
"dependency_types": [
"required"
],
"downloads": 251168597,
"project_id": "AANobbMI",
"project_type": "mod",
"required": true,
"slug": "sodium",
"title": "Sodium",
"url": "https://modrinth.com/mod/sodium",
"version_count": 10
}
],
"external_files": [],
"project": "iris",
"required_count": 1,
"versions_checked": 12
}Get a user
Get a Modrinth user's public profile: username, bio, profile picture, role and when they joined. No API key required.
Inputs
- User
usertextRequired - A Modrinth username (such as 'jellysquid3'), user ID, or profile link. 'List a project's team' gives the usernames behind a project.
Outputs
avatar_urltext- The address of their profile picture.
biotext- What they wrote about themselves.
createdtext- When they joined, as an ISO 8601 date and time.
idtext- The user's ID, such as 'TEZXhE2U'.
nametext- The display name they chose, when they set one.
roletext- Their role on Modrinth: developer, moderator or admin.
urltext- Their profile page on modrinth.com.
usernametext- Their username, such as 'jellysquid3'.
Example output
{
"avatar_url": "https://avatars2.githubusercontent.com/u/4324090?v=4",
"bio": null,
"created": "2020-12-08T21:41:49.550067Z",
"id": "JZA4dW8o",
"name": null,
"role": "developer",
"url": "https://modrinth.com/user/modmuss50",
"username": "modmuss50"
}Get a version
Get one version by its ID: its changelog, files with download links and hashes, loaders, Minecraft versions and dependencies. No API key required.
Inputs
- Version ID
version_idtextRequired - The version's ID, such as 'SMxNOGZ6', as 'List a project's versions' or a search's newest version ID gives it.
Outputs
changelogtext- What changed in this version, written in Markdown.
date_publishedtext- When it was published, as an ISO 8601 date and time.
dependencieslist- What this version needs, or refuses to run with.
download_urltext- The address to download its main file from.
downloadsnumber- How many times it has been downloaded.
file_nametext- Its main file's name.
file_sizenumber- Its main file's size in bytes.
fileslist- Every file in the version, the main one included.
game_versionslist- The Minecraft versions it works with.
idtext- The version's ID, such as 'SMxNOGZ6'.
loaderslist- The loaders it works with, such as 'fabric'.
nametext- The version's title, such as 'Sodium 0.8.13 for Fabric 1.21.1'.
project_idtext- The ID of the project it belongs to.
sha1text- Its main file's SHA-1 hash.
sha512text- Its main file's SHA-512 hash.
statustext- Its status, normally 'listed'.
urltext- The version's page on modrinth.com.
version_numbertext- Its version number, such as 'mc1.21.1-0.8.13-fabric'.
version_typetext- Its release channel: release, beta or alpha.
Example output
{
"changelog": "Sodium 0.8.13 fixes potential minor bugs and improves the crash log message to avoid misattribution of unrelated errors when NeoForge continues loading despite severe errors.",
"date_published": "2026-08-28T20:55:02.424329Z",
"dependencies": [],
"download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar",
"downloads": 1786271,
"file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
"file_size": 1574609,
"files": [
{
"file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
"file_type": null,
"primary": true,
"sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
"sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
"size": 1574609,
"url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar"
}
],
"game_versions": [
"1.21.1"
],
"id": "SMxNOGZ6",
"loaders": [
"fabric"
],
"name": "Sodium 0.8.13 for Fabric 1.21.1",
"project_id": "AANobbMI",
"sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
"sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
"status": "listed",
"url": "https://modrinth.com/project/AANobbMI/version/SMxNOGZ6",
"version_number": "mc1.21.1-0.8.13-fabric",
"version_type": "release"
}Get a version by its number
Get a project's version by the version number its authors gave it, such as '0.5.11', with its changelog, files, download links and dependencies. No API key required.
Inputs
- Project
projecttextRequired - The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
- Version number
version_numbertextRequired - The version number exactly as the project writes it, such as 'mc1.21.1-0.8.13-fabric'. A version ID works too.
Outputs
changelogtext- What changed in this version, written in Markdown.
date_publishedtext- When it was published, as an ISO 8601 date and time.
dependencieslist- What this version needs, or refuses to run with.
download_urltext- The address to download its main file from.
downloadsnumber- How many times it has been downloaded.
file_nametext- Its main file's name.
file_sizenumber- Its main file's size in bytes.
fileslist- Every file in the version, the main one included.
game_versionslist- The Minecraft versions it works with.
idtext- The version's ID, such as 'SMxNOGZ6'.
loaderslist- The loaders it works with, such as 'fabric'.
nametext- The version's title, such as 'Sodium 0.8.13 for Fabric 1.21.1'.
project_idtext- The ID of the project it belongs to.
sha1text- Its main file's SHA-1 hash.
sha512text- Its main file's SHA-512 hash.
statustext- Its status, normally 'listed'.
urltext- The version's page on modrinth.com.
version_numbertext- Its version number, such as 'mc1.21.1-0.8.13-fabric'.
version_typetext- Its release channel: release, beta or alpha.
Example output
{
"changelog": "Sodium 0.8.13 fixes potential minor bugs and improves the crash log message to avoid misattribution of unrelated errors when NeoForge continues loading despite severe errors.",
"date_published": "2026-08-28T20:55:02.424329Z",
"dependencies": [],
"download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar",
"downloads": 1786271,
"file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
"file_size": 1574609,
"files": [
{
"file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
"file_type": null,
"primary": true,
"sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
"sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
"size": 1574609,
"url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar"
}
],
"game_versions": [
"1.21.1"
],
"id": "SMxNOGZ6",
"loaders": [
"fabric"
],
"name": "Sodium 0.8.13 for Fabric 1.21.1",
"project_id": "AANobbMI",
"sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
"sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
"status": "listed",
"url": "https://modrinth.com/project/AANobbMI/version/SMxNOGZ6",
"version_number": "mc1.21.1-0.8.13-fabric",
"version_type": "release"
}Get licence text
Get the full text of a standard licence by its SPDX ID, such as a project's 'MIT' or 'LGPL-3.0-only'. A project with a licence of its own links to it instead. No API key required.
Inputs
- Licence
license_idtextRequired - The licence, as a project's licence ID gives it, such as 'MIT' or 'Apache-2.0'.
Outputs
bodytext- The licence's full text.
idtext- The licence's SPDX ID.
titletext- The licence's full name.
Example output
{
"body": "GNU LESSER GENERAL PUBLIC LICENSE\nVersion 3, 29 June 2007\n\nCopyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>\n\nEveryone is permitted to copy an",
"id": "LGPL-3.0-only",
"title": "GNU Lesser General Public License v3.0 only"
}Get random projects
Get projects picked at random from all of Modrinth, for a 'discover something new' post or a varied sample. No API key required.
Inputs
- How many
countnumber - How many projects to pick, up to 100.From 1 to 100. Default:
10.
Outputs
countnumber- How many projects came back.
projectslist- The projects Modrinth picked.
Example output
{
"count": 2,
"projects": [
{
"categories": [
"mobs",
"transportation"
],
"client_side": "optional",
"description": "Part of the Cobblemon Hacked Changes series, I am now separating my one mod into separate Datapacks. This datapack targets doduo and dodrio from generation one.",
"downloads": 52,
"followers": 0,
"icon_url": "https://cdn.modrinth.com/data/6dyhwzlE/1390d667320635f24347fa8246c87d38378a4a89.png",
"id": "6dyhwzlE",
"license_id": "MPL-2.0",
"loaders": [
"datapack"
],
"project_type": "mod",
"published": "2026-08-18T23:48:17.410126Z",
"server_side": "required",
"slug": "dodrio-and-doduo-hacked-changes",
"status": "approved",
"title": "0084-0085 Dodrio Line Hacked Changes",
"updated": "2026-09-20T19:27:15.080633Z",
"url": "https://modrinth.com/mod/dodrio-and-doduo-hacked-changes"
},
{
"categories": [
"food",
"technology",
"utility"
],
"client_side": "required",
"description": "A Create Mod Addon that adds different food items, mainly nuts.",
"downloads": 848644,
"followers": 250,
"icon_url": "https://cdn.modrinth.com/data/6e2SlzR4/cd7fa892b619c7ebe5513e9eceb2fb54c4971766_96.webp",
"id": "6e2SlzR4",
"license_id": "MIT",
"loaders": [
"fabric",
"forge",
"neoforge",
"quilt"
],
"project_type": "mod",
"published": "2023-06-27T20:08:02.358123Z",
"server_side": "required",
"slug": "create-garnished",
"status": "approved",
"title": "Create: Garnished",
"updated": "2026-09-21T02:10:25.792465Z",
"url": "https://modrinth.com/mod/create-garnished"
}
]
}Get several projects
Get up to 100 Modrinth projects in one step, by slug or ID, with their downloads, followers, loaders, licence and last update. Slugs or IDs Modrinth doesn't have are listed rather than failing the step. No API key required.
Inputs
- Projects
projectslistRequired - The projects' slugs, IDs or modrinth.com links, up to 100.
Outputs
countnumber- How many projects came back.
not_foundlist- The slugs or IDs asked for that Modrinth doesn't have.
projectslist- The projects found, in the order asked for.
Example output
{
"count": 2,
"not_found": [
"no-such-project-zz"
],
"projects": [
{
"categories": [
"optimization"
],
"client_side": "required",
"description": "A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.",
"downloads": 251168597,
"followers": 42017,
"icon_url": "https://cdn.modrinth.com/data/AANobbMI/295862f4724dc3f78df3447ad6072b2dcd3ef0c9_96.webp",
"id": "AANobbMI",
"license_id": "LicenseRef-Polyform-Shield-1.0.0",
"loaders": [
"fabric",
"neoforge",
"quilt"
],
"project_type": "mod",
"published": "2021-01-03T00:53:34.185936Z",
"server_side": "unsupported",
"slug": "sodium",
"status": "approved",
"title": "Sodium",
"updated": "2026-10-15T17:51:44.107526Z",
"url": "https://modrinth.com/mod/sodium"
},
{
"categories": [
"library"
],
"client_side": "optional",
"description": "Lightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.",
"downloads": 285917544,
"followers": 37150,
"icon_url": "https://cdn.modrinth.com/data/P7dR8mSH/icon.png",
"id": "P7dR8mSH",
"license_id": "Apache-2.0",
"loaders": [
"fabric"
],
"project_type": "mod",
"published": "2021-01-22T11:04:41.419169Z",
"server_side": "optional",
"slug": "fabric-api",
"status": "approved",
"title": "Fabric API",
"updated": "2026-10-20T16:26:07.911368Z",
"url": "https://modrinth.com/mod/fabric-api"
}
]
}Get statistics
Get how many projects, versions, files and authors Modrinth holds, for tracking the platform's growth. No API key required.
Inputs
None.
Outputs
authorsnumber- How many people have published on Modrinth.
filesnumber- How many files those versions hold.
projectsnumber- How many projects Modrinth holds.
versionsnumber- How many versions they have published.
Example output
{
"authors": 70582,
"files": 1627281,
"projects": 163601,
"versions": 1500379
}Identify files by hash
Find which project and version each mod file belongs to, from its SHA-1 or SHA-512 hash, up to 100 at a time. Files Modrinth doesn't know come back with 'found' set to false rather than failing the step. No API key required.
Inputs
- File hashes
hasheslistRequired - The SHA-1 or SHA-512 hash of each file, up to 100. Both kinds can be mixed: which is which is read from its length. Launchers and modpack files (modrinth.index.json) list these for every mod.
Outputs
countnumber- How many hashes were looked up.
fileslist- One answer per hash, in the order given.
found_countnumber- How many of them Modrinth knows.
not_found_countnumber- How many it doesn't.
Example output
{
"count": 2,
"files": [
{
"algorithm": "sha1",
"date_published": "2026-08-28T20:55:02.424329Z",
"download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar",
"file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
"found": true,
"game_versions": [
"1.21.1"
],
"hash": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
"loaders": [
"fabric"
],
"project_id": "AANobbMI",
"project_slug": "sodium",
"project_title": "Sodium",
"url": "https://modrinth.com/project/AANobbMI/version/SMxNOGZ6",
"version_id": "SMxNOGZ6",
"version_name": "Sodium 0.8.13 for Fabric 1.21.1",
"version_number": "mc1.21.1-0.8.13-fabric",
"version_type": "release"
},
{
"algorithm": "sha1",
"date_published": null,
"download_url": null,
"file_name": null,
"found": false,
"game_versions": [],
"hash": "0000000000000000000000000000000000000000",
"loaders": [],
"project_id": null,
"project_slug": null,
"project_title": null,
"url": null,
"version_id": null,
"version_name": null,
"version_number": null,
"version_type": null
}
],
"found_count": 1,
"not_found_count": 1
}List a project's team
List the people on a project's team with their roles, such as Owner or Maintainer. A project owned by an organization lists its own team only. No API key required.
Inputs
- Project
projecttextRequired - The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
Outputs
countnumber- How many members came back.
memberslist- The team, in the order the project shows it.
projecttext- The project asked about.
Example output
{
"count": 2,
"members": [
{
"accepted": true,
"avatar_url": "https://avatars.githubusercontent.com/u/1939216?v=4",
"bio": null,
"role": "Member",
"url": "https://modrinth.com/user/Player7457",
"user_id": "iFMgB5Ib",
"username": "Player7457"
},
{
"accepted": true,
"avatar_url": "https://avatars2.githubusercontent.com/u/4324090?v=4",
"bio": null,
"role": "Owner",
"url": "https://modrinth.com/user/modmuss50",
"user_id": "JZA4dW8o",
"username": "modmuss50"
}
],
"project": "fabric-api"
}List a project's versions
List a project's versions, newest first, with their files, download links, hashes, loaders, Minecraft versions and dependencies. Narrow by loader, Minecraft version, release channel, or to the versions the project features. No API key required.
Inputs
- Project
projecttextRequired - The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
- Loaders
loaderslist - Only versions for these loaders, such as Fabric or NeoForge. Any one of them is enough. Leave empty for every loader.
- Minecraft versions
game_versionslist - Only versions for these Minecraft versions. Any one of them is enough. The list offers release versions; type a snapshot such as '26.4-snapshot-4' to use one. Leave empty for every Minecraft version.
- Release channel
version_typetext - Only releases, betas or alphas. Leave empty for all three.One of:
release,beta,alpha. - Featured only
featured_onlytrue/false - Only the versions the project's authors feature on its page, usually the recommended one per Minecraft version.Default:
false. - How many to return
limitnumber - How many versions to return, newest first, up to 500.From 1 to 500. Default:
25.
Outputs
countnumber- How many versions came back.
more_availabletrue/false- Whether raising the limit would return more.
projecttext- The project asked about.
total_matchingnumber- How many versions match the filters altogether.
versionslist- Its versions, newest first.
Example output
{
"count": 2,
"more_available": true,
"project": "fabric-api",
"total_matching": 36,
"versions": [
{
"date_published": "2026-09-01T16:40:04.373428Z",
"dependencies": [],
"download_url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/Mys3P7lK/fabric-api-0.116.17%2B1.21.1.jar",
"downloads": 2975785,
"file_name": "fabric-api-0.116.17+1.21.1.jar",
"file_size": 2452735,
"files": [
{
"file_name": "fabric-api-0.116.17+1.21.1.jar",
"file_type": null,
"primary": true,
"sha1": "810b2b0195371a012906241d8b85a32a1d6de53c",
"sha512": "98c478217da19181f0e4df3ea6c2da6bdbda271c7544a4aea048513a49b444f1ff5b71dc0df6303017c48e8ff69b7bb6af6179bdf0d0e09ab3c1ee08411857a8",
"size": 2452735,
"url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/Mys3P7lK/fabric-api-0.116.17%2B1.21.1.jar"
}
],
"game_versions": [
"1.21.1"
],
"id": "Mys3P7lK",
"loaders": [
"fabric"
],
"name": "[1.21.1] Fabric API 0.116.17+1.21.1",
"project_id": "P7dR8mSH",
"sha1": "810b2b0195371a012906241d8b85a32a1d6de53c",
"sha512": "98c478217da19181f0e4df3ea6c2da6bdbda271c7544a4aea048513a49b444f1ff5b71dc0df6303017c48e8ff69b7bb6af6179bdf0d0e09ab3c1ee08411857a8",
"status": "listed",
"url": "https://modrinth.com/project/P7dR8mSH/version/Mys3P7lK",
"version_number": "0.116.17+1.21.1",
"version_type": "release"
},
{
"date_published": "2026-09-01T10:29:57.072338Z",
"dependencies": [],
"download_url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/fpB2VatZ/fabric-api-0.116.16%2B1.21.1.jar",
"downloads": 26657,
"file_name": "fabric-api-0.116.16+1.21.1.jar",
"file_size": 2467467,
"files": [
{
"file_name": "fabric-api-0.116.16+1.21.1.jar",
"file_type": null,
"primary": true,
"sha1": "07fcbd957f45592ac3ac63161b0bf4f0b724c665",
"sha512": "1ee763b538619b917b3bf02568dd2fb6c4ca3dc98e5554dc944e4524c316437946b00b6c1c4597ca86871f820b894c4b7b2b5701f7479e2dd057b0ea947886df",
"size": 2467467,
"url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/fpB2VatZ/fabric-api-0.116.16%2B1.21.1.jar"
}
],
"game_versions": [
"1.21.1"
],
"id": "fpB2VatZ",
"loaders": [
"fabric"
],
"name": "[1.21.1] Fabric API 0.116.16+1.21.1",
"project_id": "P7dR8mSH",
"sha1": "07fcbd957f45592ac3ac63161b0bf4f0b724c665",
"sha512": "1ee763b538619b917b3bf02568dd2fb6c4ca3dc98e5554dc944e4524c316437946b00b6c1c4597ca86871f820b894c4b7b2b5701f7479e2dd057b0ea947886df",
"status": "listed",
"url": "https://modrinth.com/project/P7dR8mSH/version/fpB2VatZ",
"version_number": "0.116.16+1.21.1",
"version_type": "release"
}
]
}List a user's projects
List the projects a Modrinth user publishes, most downloaded first, with their downloads added up. No API key required.
Inputs
- User
usertextRequired - A Modrinth username (such as 'jellysquid3'), user ID, or profile link. 'List a project's team' gives the usernames behind a project.
Outputs
countnumber- How many projects came back.
projectslist- Their projects, most downloaded first.
total_downloadsnumber- Their projects' downloads added together.
usertext- The user asked about.
Example output
{
"count": 2,
"projects": [
{
"categories": [
"optimization"
],
"client_side": "required",
"description": "A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.",
"downloads": 251168597,
"followers": 42017,
"icon_url": "https://cdn.modrinth.com/data/AANobbMI/295862f4724dc3f78df3447ad6072b2dcd3ef0c9_96.webp",
"id": "AANobbMI",
"license_id": "LicenseRef-Polyform-Shield-1.0.0",
"loaders": [
"fabric",
"neoforge",
"quilt"
],
"project_type": "mod",
"published": "2021-01-03T00:53:34.185936Z",
"server_side": "unsupported",
"slug": "sodium",
"status": "approved",
"title": "Sodium",
"updated": "2026-10-15T17:51:44.107526Z",
"url": "https://modrinth.com/mod/sodium"
},
{
"categories": [
"optimization"
],
"client_side": "optional",
"description": "No-compromises game logic optimization mod, useful for both single-player games and multi-player servers.",
"downloads": 140925772,
"followers": 24033,
"icon_url": "https://cdn.modrinth.com/data/gvQqBUqZ/bcc8686c13af0143adf4285d741256af824f70b7_96.webp",
"id": "gvQqBUqZ",
"license_id": "LGPL-3.0-only",
"loaders": [
"fabric",
"neoforge",
"quilt"
],
"project_type": "mod",
"published": "2021-01-03T00:56:52.292581Z",
"server_side": "optional",
"slug": "lithium",
"status": "approved",
"title": "Lithium",
"updated": "2026-09-28T03:43:35.615649Z",
"url": "https://modrinth.com/mod/lithium"
}
],
"total_downloads": 392094369,
"user": "jellysquid3"
}List categories
List the categories projects are filed under on Modrinth, such as Optimization, Worldgen or 16x, with the project type each belongs to. No API key required.
Inputs
- Project type
project_typetext - Only those used by this type of project. Leave empty for all.One of:
mod(Mods),modpack(Modpacks),resourcepack(Resource packs),shader(Shaders),plugin(Plugins),datapack(Data packs),minecraft_java_server(Servers).
Outputs
categorieslist- The categories, grouped by project type.
countnumber- How many categories came back.
project_typetext- The project type they were narrowed to, if any.
Example output
{
"categories": [
{
"group": "Categories",
"label": "Cartoon",
"name": "cartoon",
"project_type": "shader"
},
{
"group": "Categories",
"label": "Cursed",
"name": "cursed",
"project_type": "shader"
},
{
"group": "Categories",
"label": "Fantasy",
"name": "fantasy",
"project_type": "shader"
}
],
"count": 3,
"project_type": "shader"
}List loaders
List the loaders and platforms Modrinth knows, such as Fabric, NeoForge, Paper or Iris, with the project types each is used for. No API key required.
Inputs
- Project type
project_typetext - Only those used by this type of project. Leave empty for all.One of:
mod(Mods),modpack(Modpacks),resourcepack(Resource packs),shader(Shaders),plugin(Plugins),datapack(Data packs),minecraft_java_server(Servers).
Outputs
countnumber- How many loaders came back.
loaderslist- The loaders, by name.
project_typetext- The project type they were narrowed to, if any.
Example output
{
"count": 4,
"loaders": [
{
"label": "Fabric",
"name": "fabric",
"project_types": [
"mod",
"modpack"
]
},
{
"label": "Forge",
"name": "forge",
"project_types": [
"mod",
"modpack"
]
},
{
"label": "NeoForge",
"name": "neoforge",
"project_types": [
"mod",
"modpack"
]
},
{
"label": "Quilt",
"name": "quilt",
"project_types": [
"mod",
"modpack"
]
}
],
"project_type": "modpack"
}List Minecraft versions
List Minecraft versions, newest first, with the date each came out: releases by default, or snapshots, old betas and alphas. The newest comes back on its own too, so a workflow can notice a new Minecraft release. No API key required.
Inputs
- Which versions
version_typetext - Releases by default.One of:
release(Releases),snapshot(Snapshots),beta(Old betas),alpha(Old alphas),all(All of them). Default:release.
Outputs
countnumber- How many versions came back.
game_versionslist- The Minecraft versions, newest first.
latesttext- The newest version listed.
version_typetext- Which kind of version was listed, or 'all'.
Example output
{
"count": 3,
"game_versions": [
{
"release_date": "2026-09-15T11:23:02Z",
"version": "26.3",
"version_type": "release"
},
{
"release_date": "2026-06-16T12:03:33Z",
"version": "26.2",
"version_type": "release"
},
{
"release_date": "2026-04-09T10:12:23Z",
"version": "26.1.2",
"version_type": "release"
}
],
"latest": "26.3",
"version_type": "release"
}Search projects
Find Minecraft mods, modpacks, resource packs, shaders, plugins, data packs and servers on Modrinth by name or words, narrowed by type, category, loader, Minecraft version, whether it runs in the player's game or on a server, and open source. Sort by best match, downloads, followers, newest or recently updated. Each result comes with its downloads, loaders, licence and the ID of its newest version. No API key required.
Inputs
- Search text
querytext - Words to look for in project names and summaries. Leave empty to browse with the filters alone.
- Project type
project_typetext - Only this type of project. Leave empty for every type.One of:
mod(Mods),modpack(Modpacks),resourcepack(Resource packs),shader(Shaders),plugin(Plugins),datapack(Data packs),minecraft_java_server(Servers). - Categories
categorieslist - Only projects filed under every one of these categories, such as Optimization or Worldgen. Leave empty for any.
- Loaders
loaderslist - Only projects for any of these loaders, such as Fabric, NeoForge or Paper. Leave empty for every loader.
- Minecraft versions
game_versionslist - Only projects with a file for any of these Minecraft versions. The list offers release versions; type a snapshot to use one. Leave empty for every version.
- Where it runs
environmenttext - Only projects that run in the player's game, on a server, or only in one of the two. Leave empty for all.One of:
client(Works in the player's game),server(Works on a server),client_only(Only in the player's game),server_only(Only on a server). - Open source only
open_source_onlytrue/false - Only projects published under an open source licence.Default:
false. - Sort by
sorttext - The order of the results. Best match by default.One of:
relevance(Best match),downloads(Most downloaded),follows(Most followed),newest,updated(Recently updated). Default:relevance. - How many to return
limitnumber - How many projects to return, up to 100.From 1 to 100. Default:
10. - Skip
offsetnumber - How many matching projects to skip, to read the next page: with 10 a page, 10 reads the second page.At least 0. Default:
0.
Outputs
countnumber- How many projects came back.
more_availabletrue/false- Whether a further page would return more.
offsetnumber- How many matching projects were skipped.
projectslist- The projects found, in the order asked for.
sorttext- How the results were ordered.
total_hitsnumber- How many projects match altogether.
Example output
{
"count": 2,
"more_available": true,
"offset": 0,
"projects": [
{
"author": "jellysquid3",
"categories": [
"optimization"
],
"client_side": "required",
"created": "2021-01-03T00:53:34.185936+00:00",
"description": "A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.",
"downloads": 250585660,
"followers": 41999,
"icon_url": "https://cdn.modrinth.com/data/AANobbMI/295862f4724dc3f78df3447ad6072b2dcd3ef0c9_96.webp",
"id": "AANobbMI",
"latest_version_id": "SMxNOGZ6",
"license_id": "LicenseRef-Polyform-Shield-1.0.0",
"loaders": [
"fabric",
"neoforge",
"quilt"
],
"project_type": "mod",
"project_types": [
"mod"
],
"server_side": "unsupported",
"slug": "sodium",
"title": "Sodium",
"updated": "2026-10-15T17:51:36.063140+00:00",
"url": "https://modrinth.com/mod/sodium"
},
{
"author": "FlashyReese",
"categories": [
"cursed",
"optimization",
"utility"
],
"client_side": "required",
"created": "2021-02-17T04:37:04.928784+00:00",
"description": "A Sodium addon that adds features that shouldn't be in Sodium.",
"downloads": 105327434,
"followers": 13746,
"icon_url": "https://cdn.modrinth.com/data/PtjYWJkn/0df4fb22a11e1dcb5e83cb0aadd275b571aca7a9_96.webp",
"id": "PtjYWJkn",
"latest_version_id": "YEWu6red",
"license_id": "LGPL-3.0-only",
"loaders": [
"fabric",
"neoforge",
"quilt"
],
"project_type": "mod",
"project_types": [
"mod"
],
"server_side": "unsupported",
"slug": "sodium-extra",
"title": "Sodium Extra",
"updated": "2026-09-16T02:48:16.702643+00:00",
"url": "https://modrinth.com/mod/sodium-extra"
}
],
"sort": "downloads",
"total_hits": 25
}