Call us, not every catalogue
Your code talks to api.modpacks.ch. We handle the differences between CurseForge, Modrinth and the other catalogues we support.
Public API · v1
One API for mods, packs and the files they need.
Ask Modpacks.ch once. We fetch and cache the project data, tidy up the differences between catalogues and return the fields your site, tool or launcher actually needs. Every result still says where it came from and links back to the official project page.
Forge, NeoForge and Fabric stay distinct
Releases retain their game and loader targets. The loader route exposes the actual Forge, NeoForge, Fabric and Quilt versions available for a Minecraft version.
Busy pages don't multiply the work
Popular responses are cached and refreshed in one place. A traffic spike doesn't need to ask every source for the same project all over again.
1 endpoints
Health
Check whether the API is ready.
GET /health Health check
Checks whether the API process is ready to receive requests.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/health'Responses
200 Plain text OK. string
OK24 endpoints
Modpacks
Find modpacks and inspect their files.
GET /public/modpack/browse/{filter} Browse modpacks
Returns a paged list of modpacks. Filters can include loader, game version, tag, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/browse/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, tag, loader, or game version. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadBrowsePayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "100",
"name": "Example Pack",
"provider": "modpacks.ch",
"synopsis": "A short pack summary.",
"type": "release",
"updated": 1710000000,
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"installs": 1200
}
],
"page": "1",
"pages": 4
}GET /public/modpack/browse/{filter}/{secondFilter} Browse modpacks
Returns a paged list of modpacks. Filters can include loader, game version, tag, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/browse/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, tag, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadBrowsePayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "100",
"name": "Example Pack",
"provider": "modpacks.ch",
"synopsis": "A short pack summary.",
"type": "release",
"updated": 1710000000,
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"installs": 1200
}
],
"page": "1",
"pages": 4
}GET /public/modpack/browse/{filter}/{secondFilter}/{thirdFilter} Browse modpacks
Returns a paged list of modpacks. Filters can include loader, game version, tag, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, tag, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadBrowsePayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "100",
"name": "Example Pack",
"provider": "modpacks.ch",
"synopsis": "A short pack summary.",
"type": "release",
"updated": 1710000000,
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"installs": 1200
}
],
"page": "1",
"pages": 4
}GET /public/modpack/browse/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse modpacks
Returns a paged list of modpacks. Filters can include loader, game version, tag, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, tag, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field: new, featured, updated, or popular. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadBrowsePayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "100",
"name": "Example Pack",
"provider": "modpacks.ch",
"synopsis": "A short pack summary.",
"type": "release",
"updated": 1710000000,
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"installs": 1200
}
],
"page": "1",
"pages": 4
}GET /public/modpack/browse/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse modpacks
Returns a paged list of modpacks. Filters can include loader, game version, tag, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, tag, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field: new, featured, updated, or popular. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadBrowsePayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "100",
"name": "Example Pack",
"provider": "modpacks.ch",
"synopsis": "A short pack summary.",
"type": "release",
"updated": 1710000000,
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"installs": 1200
}
],
"page": "1",
"pages": 4
}GET /public/modpack/{id}/{versionid}/changelog Get version changelog
Returns the changelog text for a modpack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/238222/%7Bversionid%7D/changelog'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Parent modpack ID. |
versionid required | path | integer (int32) | Version ID. |
Responses
200 JSON object with status, content, and updated. ModpackApiDataResponsePayloadChangelogPayload
{
"status": "success",
"content": "Updated mods and configuration.",
"updated": 1710000000
}GET /public/modpack/{id} Get modpack
Returns a full modpack record with metadata, artwork, authors, tags, links, versions, targets, recommendations, and rating data.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/238222'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Modpack ID. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, plays, tags, rating, released, provider, and private. ModpackApiDataResponsePayloadModpackPayload
{
"synopsis": "A short pack summary.",
"description": "A longer pack description.",
"art": [
{
"id": 300,
"type": "square",
"updated": 1710000000,
"url": "https://example.com/art.png",
"mirrors": [],
"sha1": "0000000000000000000000000000000000000000",
"size": 1024,
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"versions": [
{
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}
],
"installs": 1200,
"plays": 3400,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"featured": true,
"refreshed": 1710000000,
"notification": "",
"rating": {
"id": -1,
"configured": false,
"verified": false,
"age": 7,
"gambling": false,
"frightening": true,
"alcoholdrugs": false,
"nuditysexual": false,
"sterotypeshate": false,
"language": false,
"violence": true
},
"status": "success",
"released": 1710000000,
"provider": "modpacks.ch",
"plays_14d": 120,
"private": false,
"id": 100,
"name": "Example Pack",
"type": "release",
"updated": 1710000000
}GET /public/modpack/all List modpacks
Returns modpack ID lists for all, new, featured, updated, or private modpacks.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/all'Responses
200 JSON object with status, packs, total, limit, and refreshed. ModpackApiDataResponsePayloadPackIdListPayload
{
"packs": [
100,
101
],
"total": 2,
"limit": 25,
"refreshed": 1710000000,
"status": "success"
}GET /public/modpack/new/{limit} List modpacks
Returns modpack ID lists for all, new, featured, updated, or private modpacks.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/new/20'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit required | path | integer (int32) | Maximum number of pack IDs to return. |
Responses
200 JSON object with status, packs, total, limit, and refreshed. ModpackApiDataResponsePayloadPackIdListPayload
{
"packs": [
100,
101
],
"total": 2,
"limit": 25,
"refreshed": 1710000000,
"status": "success"
}GET /public/modpack/featured/{limit} List modpacks
Returns modpack ID lists for all, new, featured, updated, or private modpacks.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/featured/20'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit required | path | integer (int32) | Maximum number of pack IDs to return. |
Responses
200 JSON object with status, packs, total, limit, and refreshed. ModpackApiDataResponsePayloadPackIdListPayload
{
"packs": [
100,
101
],
"total": 2,
"limit": 25,
"refreshed": 1710000000,
"status": "success"
}GET /public/modpack/updated/{limit} List modpacks
Returns modpack ID lists for all, new, featured, updated, or private modpacks.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/updated/20'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit required | path | integer (int32) | Maximum number of pack IDs to return. |
Responses
200 JSON object with status, packs, total, limit, and refreshed. ModpackApiDataResponsePayloadPackIdListPayload
{
"packs": [
100,
101
],
"total": 2,
"limit": 25,
"refreshed": 1710000000,
"status": "success"
}GET /public/modpack/popular/{metric}/{limitOrTag} Popular modpacks
Returns popular modpack IDs by plays or installs, optionally limited to a tag or recent day range.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/popular/%7Bmetric%7D/%7BlimitOrTag%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
metric required | path | string | Popularity metric: plays or installs. |
limitOrTag required | path | string | Maximum result count, tag, or game version. |
Responses
200 JSON object with status, packs, total, type, limit, refreshed, and optional days. ModpackApiDataResponsePayloadPopularPacksPayload
{
"packs": [
100,
101
],
"total": 2,
"type": "plays",
"limit": 25,
"status": "success",
"refreshed": 1710000000,
"days": 14
}GET /public/modpack/popular/{metric}/{limitOrTag}/{daysOrLimit} Popular modpacks
Returns popular modpack IDs by plays or installs, optionally limited to a tag or recent day range.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/popular/%7Bmetric%7D/%7BlimitOrTag%7D/%7BdaysOrLimit%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
metric required | path | string | Popularity metric: plays or installs. |
limitOrTag required | path | string | Maximum result count, tag, or game version. |
daysOrLimit required | path | string | Optional day range for count requests, or result count for tag requests. |
Responses
200 JSON object with status, packs, total, type, limit, refreshed, and optional days. ModpackApiDataResponsePayloadPopularPacksPayload
{
"packs": [
100,
101
],
"total": 2,
"type": "plays",
"limit": 25,
"status": "success",
"refreshed": 1710000000,
"days": 14
}GET /public/modpack/search/{mode} Search modpacks
Searches modpacks using the term query parameter. Results can be returned as IDs, detailed pack cards, or filtered browse-style results.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/search/%7Bmode%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
mode required | path | string | Result limit, or first filter for browse-style search. |
Responses
200 JSON object with packs, total, limit, refreshed, and optionally curseforge IDs or pagination fields. ModpackApiDataResponsePayloadSearchPayload
{
"packs": [
100,
101
],
"curseforge": [
5000
],
"total": 3,
"limit": 25,
"refreshed": 1710000000
}GET /public/modpack/search/{mode}/{detailOrFilter} Search modpacks
Searches modpacks using the term query parameter. Results can be returned as IDs, detailed pack cards, or filtered browse-style results.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/search/%7Bmode%7D/%7BdetailOrFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
mode required | path | string | Result limit, or first filter for browse-style search. |
detailOrFilter required | path | string | Use detailed for detailed results, or provide another filter. |
Responses
200 JSON object with packs, total, limit, refreshed, and optionally curseforge IDs or pagination fields. ModpackApiDataResponsePayloadSearchPayload
{
"packs": [
100,
101
],
"curseforge": [
5000
],
"total": 3,
"limit": 25,
"refreshed": 1710000000
}GET /public/modpack/search/{mode}/{detailOrFilter}/{secondFilter} Search modpacks
Searches modpacks using the term query parameter. Results can be returned as IDs, detailed pack cards, or filtered browse-style results.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/search/%7Bmode%7D/%7BdetailOrFilter%7D/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
mode required | path | string | Result limit, or first filter for browse-style search. |
detailOrFilter required | path | string | Use detailed for detailed results, or provide another filter. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with packs, total, limit, refreshed, and optionally curseforge IDs or pagination fields. ModpackApiDataResponsePayloadSearchPayload
{
"packs": [
100,
101
],
"curseforge": [
5000
],
"total": 3,
"limit": 25,
"refreshed": 1710000000
}GET /public/modpack/search/{mode}/{detailOrFilter}/{secondFilter}/{sort} Search modpacks
Searches modpacks using the term query parameter. Results can be returned as IDs, detailed pack cards, or filtered browse-style results.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/search/%7Bmode%7D/%7BdetailOrFilter%7D/%7BsecondFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
mode required | path | string | Result limit, or first filter for browse-style search. |
detailOrFilter required | path | string | Use detailed for detailed results, or provide another filter. |
secondFilter required | path | string | Optional second filter. |
sort required | path | string | Optional sort field for browse-style search. |
Responses
200 JSON object with packs, total, limit, refreshed, and optionally curseforge IDs or pagination fields. ModpackApiDataResponsePayloadSearchPayload
{
"packs": [
100,
101
],
"curseforge": [
5000
],
"total": 3,
"limit": 25,
"refreshed": 1710000000
}GET /public/modpack/search/{mode}/{detailOrFilter}/{secondFilter}/{sort}/{page} Search modpacks
Searches modpacks using the term query parameter. Results can be returned as IDs, detailed pack cards, or filtered browse-style results.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/search/%7Bmode%7D/%7BdetailOrFilter%7D/%7BsecondFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
mode required | path | string | Result limit, or first filter for browse-style search. |
detailOrFilter required | path | string | Use detailed for detailed results, or provide another filter. |
secondFilter required | path | string | Optional second filter. |
sort required | path | string | Optional sort field for browse-style search. |
page required | path | string | Optional page number. |
Responses
200 JSON object with packs, total, limit, refreshed, and optionally curseforge IDs or pagination fields. ModpackApiDataResponsePayloadSearchPayload
{
"packs": [
100,
101
],
"curseforge": [
5000
],
"total": 3,
"limit": 25,
"refreshed": 1710000000
}GET /public/modpack/{id}/{versionid}/server/{platform} Download server installer
Downloads the platform-specific server installer binary for a modpack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/238222/%7Bversionid%7D/server/%7Bplatform%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Parent modpack ID. |
versionid required | path | integer (int32) | Version ID. |
platform required | path | string | Target platform: linux, mac, freebsd, or windows. |
Responses
200 Binary installer stream. string (binary)
TVoAAA==GET /public/modpack/{id}/{versionid}/server/{arch}/{platform} Download server installer
Downloads the platform-specific server installer binary for a modpack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/238222/%7Bversionid%7D/server/%7Barch%7D/%7Bplatform%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Parent modpack ID. |
versionid required | path | integer (int32) | Version ID. |
arch required | path | string | Optional architecture, such as arm or arm64. |
platform required | path | string | Target platform: linux, mac, freebsd, or windows. |
Responses
200 Binary installer stream. string (binary)
TVoAAA==GET /public/modpack/{id}/{versionid} Get modpack version
Returns a full modpack version record, including targets, files, recommendations, changelog text, and provider metadata where available.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/238222/%7Bversionid%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Parent modpack ID. |
versionid required | path | integer (int32) | Version ID. The resolve route can be used when only the version ID is known. |
Responses
200 JSON object with status, id, name, type, parent, targets, specs, files, links, installs, plays, refreshed, changelog, notification, and private. ModpackApiDataResponsePayloadVersionPayload
{
"status": "success",
"installs": 1200,
"plays": 3400,
"refreshed": 1710000000,
"changelog": "Updated mods and configuration.",
"parent": 100,
"notification": "",
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"files": [
{
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-mod.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"clientonly": false,
"serveronly": false,
"optional": false,
"curseforge": {
"project": "5000",
"file": "6000"
},
"id": 6000,
"name": "example-mod.jar",
"type": "mod",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}GET /public/modpack/resolve/{versionid} Get modpack version
Returns a full modpack version record, including targets, files, recommendations, changelog text, and provider metadata where available.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/resolve/%7Bversionid%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
versionid required | path | integer (int32) | Version ID. The resolve route can be used when only the version ID is known. |
Responses
200 JSON object with status, id, name, type, parent, targets, specs, files, links, installs, plays, refreshed, changelog, notification, and private. ModpackApiDataResponsePayloadVersionPayload
{
"status": "success",
"installs": 1200,
"plays": 3400,
"refreshed": 1710000000,
"changelog": "Updated mods and configuration.",
"parent": 100,
"notification": "",
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"files": [
{
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-mod.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"clientonly": false,
"serveronly": false,
"optional": false,
"curseforge": {
"project": "5000",
"file": "6000"
},
"id": 6000,
"name": "example-mod.jar",
"type": "mod",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}GET /public/modpack/{id}/{versionid}/mods Get version mods
Returns the mod metadata associated with a modpack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modpack/238222/%7Bversionid%7D/mods'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Parent modpack ID. |
versionid required | path | integer (int32) | Version ID. |
Responses
200 JSON object with status, id, name, parent, targets, specs, mods, and refreshed. ModpackApiDataResponsePayloadVersionModsPayload
{
"status": "success",
"installs": 1200,
"plays": 3400,
"refreshed": 1710000000,
"changelog": "",
"parent": 100,
"notification": "",
"links": [],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"files": "",
"mods": [
{
"fileId": 6000,
"name": "Example Mod",
"filename": "example-mod.jar",
"synopsis": "A short mod summary.",
"icon": "https://example.com/icon.png",
"curseSlug": "example-mod",
"curseProject": 5000,
"curseFile": 6000,
"stored": 1710000000
}
],
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}2 endpoints
Plugins
Find Bukkit plugins for Minecraft servers.
GET /public/plugin/{id} Get Bukkit plugin
Returns a CurseForge Bukkit plugin record by project ID.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/plugin/238222'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | CurseForge Bukkit plugin project ID. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, and refreshed. ModpackApiDataResponsePayloadProviderModPayload
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}GET /public/plugin/search/{limit} Search Bukkit plugins
Searches CurseForge Bukkit plugins using the required term query parameter.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/plugin/search/20?term=create'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit required | path | string | Maximum number of plugin IDs to return. |
term required | query | string | Bukkit plugin name or search term. |
Responses
200 JSON object with plugins, total, limit, and refreshed. ModpackApiDataResponsePayloadPluginSearchPayload
{
"plugins": [
9000,
9001
],
"total": 2,
"limit": 25,
"refreshed": 1710000000
}9 endpoints
Mods
Find mods, look them up by ID or hash, and inspect their files.
GET /public/mod/{id} Get mod
Returns a mod record by provider ID, Modrinth ID, or file hash. Provider-authored description Markdown must be treated as untrusted content.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/238222'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Provider project ID, Modrinth ID, or file hash. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, provider, and refreshed. ModpackApiDataResponsePayloadProviderModPayload
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}GET /public/mod/lookup Look up mod metadata
Looks up mod metadata by hash. POST requests can submit multiple hashes.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/lookup'Responses
200 Single lookup returns JSON with status and meta. Batch lookup returns JSON with status and mods. ModpackApiDataResponsePayloadModMetadataLookupPayload
{
"status": "success",
"meta": {
"fileId": 6000,
"name": "Example Mod",
"filename": "example-mod.jar",
"synopsis": "A short mod summary.",
"icon": "https://example.com/icon.png",
"curseSlug": "example-mod",
"curseProject": 5000,
"curseFile": 6000,
"stored": 1710000000
}
}POST /public/mod/lookup Look up mod metadata
Looks up mod metadata by hash. POST requests can submit multiple hashes.
Request
Link to endpointcurl --request POST 'https://api.modpacks.ch/public/mod/lookup'Responses
200 Single lookup returns JSON with status and meta. Batch lookup returns JSON with status and mods. ModpackApiDataResponsePayloadModMetadataLookupPayload
{
"status": "success",
"meta": {
"fileId": 6000,
"name": "Example Mod",
"filename": "example-mod.jar",
"synopsis": "A short mod summary.",
"icon": "https://example.com/icon.png",
"curseSlug": "example-mod",
"curseProject": 5000,
"curseFile": 6000,
"stored": 1710000000
}
}GET /public/mod/lookup/{hash} Look up mod metadata
Looks up mod metadata by hash. POST requests can submit multiple hashes.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/lookup/sha1-hash'Parameters
| Name | In | Type | Description |
|---|---|---|---|
hash required | path | string | Optional file hash for single-hash lookups. |
Responses
200 Single lookup returns JSON with status and meta. Batch lookup returns JSON with status and mods. ModpackApiDataResponsePayloadModMetadataLookupPayload
{
"status": "success",
"meta": {
"fileId": 6000,
"name": "Example Mod",
"filename": "example-mod.jar",
"synopsis": "A short mod summary.",
"icon": "https://example.com/icon.png",
"curseSlug": "example-mod",
"curseProject": 5000,
"curseFile": 6000,
"stored": 1710000000
}
}POST /public/mod/lookup/{hash} Look up mod metadata
Looks up mod metadata by hash. POST requests can submit multiple hashes.
Request
Link to endpointcurl --request POST 'https://api.modpacks.ch/public/mod/lookup/sha1-hash'Parameters
| Name | In | Type | Description |
|---|---|---|---|
hash required | path | string | Optional file hash for single-hash lookups. |
Responses
200 Single lookup returns JSON with status and meta. Batch lookup returns JSON with status and mods. ModpackApiDataResponsePayloadModMetadataLookupPayload
{
"status": "success",
"meta": {
"fileId": 6000,
"name": "Example Mod",
"filename": "example-mod.jar",
"synopsis": "A short mod summary.",
"icon": "https://example.com/icon.png",
"curseSlug": "example-mod",
"curseProject": 5000,
"curseFile": 6000,
"stored": 1710000000
}
}GET /public/mod/search/{limitOrGameVersion} Search mods
Searches mod providers using the term query parameter, with optional game version and loader filters.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/search/%7BlimitOrGameVersion%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limitOrGameVersion required | path | string | Result limit, or Minecraft game version. |
Responses
200 JSON object with mods, total, limit, term, and refreshed. ModpackApiDataResponsePayloadModSearchPayload
{
"mods": [
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}
],
"total": 1,
"limit": 25,
"term": "example",
"refreshed": 1710000000
}GET /public/mod/search/{limitOrGameVersion}/{loaderOrLimit} Search mods
Searches mod providers using the term query parameter, with optional game version and loader filters.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/search/%7BlimitOrGameVersion%7D/%7BloaderOrLimit%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limitOrGameVersion required | path | string | Result limit, or Minecraft game version. |
loaderOrLimit required | path | string | Loader filter, or result limit when a game version is supplied. |
Responses
200 JSON object with mods, total, limit, term, and refreshed. ModpackApiDataResponsePayloadModSearchPayload
{
"mods": [
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}
],
"total": 1,
"limit": 25,
"term": "example",
"refreshed": 1710000000
}GET /public/mod/search/{limitOrGameVersion}/{loaderOrLimit}/{limit} Search mods
Searches mod providers using the term query parameter, with optional game version and loader filters.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/search/%7BlimitOrGameVersion%7D/%7BloaderOrLimit%7D/20'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limitOrGameVersion required | path | string | Result limit, or Minecraft game version. |
loaderOrLimit required | path | string | Loader filter, or result limit when a game version is supplied. |
limit required | path | string | Result limit when game version and loader are supplied. |
Responses
200 JSON object with mods, total, limit, term, and refreshed. ModpackApiDataResponsePayloadModSearchPayload
{
"mods": [
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}
],
"total": 1,
"limit": 25,
"term": "example",
"refreshed": 1710000000
}GET /public/mod/search/{limitOrGameVersion}/{loaderOrLimit}/{limit}/{variant} Search mods
Searches mod providers using the term query parameter, with optional game version and loader filters.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/mod/search/%7BlimitOrGameVersion%7D/%7BloaderOrLimit%7D/20/%7Bvariant%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
limitOrGameVersion required | path | string | Result limit, or Minecraft game version. |
loaderOrLimit required | path | string | Loader filter, or result limit when a game version is supplied. |
limit required | path | string | Result limit when game version and loader are supplied. |
variant required | path | string | Optional search variant. |
Responses
200 JSON object with mods, total, limit, term, and refreshed. ModpackApiDataResponsePayloadModSearchPayload
{
"mods": [
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}
],
"total": 1,
"limit": 25,
"term": "example",
"refreshed": 1710000000
}27 endpoints
Modrinth
Browse and search Modrinth projects through Modpacks.ch.
GET /public/modrinth/browse/{filter} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/browse/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/browse/{filter}/{secondFilter} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/browse/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/browse/{filter}/{secondFilter}/{thirdFilter} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/browse/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/browse/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/search/{filter} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/search/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/search/{filter}/{secondFilter} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/search/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/search/{filter}/{secondFilter}/{thirdFilter} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/search/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/search/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse Modrinth modpacks
Returns a paged list of Modrinth modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/browse/{filter} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/browse/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/browse/{filter}/{secondFilter} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/browse/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/browse/{filter}/{secondFilter}/{thirdFilter} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/browse/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/browse/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/search/{filter} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/search/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/search/{filter}/{secondFilter} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/search/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/search/{filter}/{secondFilter}/{thirdFilter} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/search/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/mods/search/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse Modrinth mods
Returns a paged list of Modrinth mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": "AABBCCDD",
"name": "Example Modrinth Project",
"updated": 1710000000,
"synopsis": "A short Modrinth project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": -1,
"name": "ExampleAuthor",
"type": "modrinth",
"website": "https://modrinth.com/user/ExampleAuthor",
"updated": 1710000000
}
],
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"provider": "modrinth",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/modrinth/{projectIdOrSlug} Get Modrinth modpack
Returns a Modrinth modpack using the established modpacks.ch/CurseForge response envelope. Provider-authored Markdown must be treated as untrusted content.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/%7BprojectIdOrSlug%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
projectIdOrSlug required | path | string | Modrinth project ID or slug. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, provider, and refreshed. object
{
"id": "AABBCCDD",
"name": "Example Modrinth Pack",
"type": "release",
"updated": 1710000000,
"synopsis": "A short pack summary.",
"description": "## About this pack\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"versions": [
{
"id": "IIJJKKLL",
"name": "1.0.0",
"type": "release",
"updated": 1710000000,
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"private": false
}
],
"installs": 1200,
"plays": 0,
"tags": [
{
"id": "technology",
"name": "technology"
}
],
"featured": false,
"refreshed": 1710000000,
"notification": "",
"rating": {
"id": -1,
"configured": false,
"verified": false,
"age": 7,
"gambling": false,
"frightening": true,
"alcoholdrugs": false,
"nuditysexual": false,
"sterotypeshate": false,
"language": false,
"violence": true
},
"status": "success",
"released": 1710000000,
"provider": "modrinth",
"plays_14d": 0,
"private": false
}GET /public/modrinth/{projectIdOrSlug}/{versionId} Get a parsed Modrinth modpack version
Downloads the primary .mrpack, parses modrinth.index.json into the standard files array, and appends the source archive as type mr-extract. Resolved entries use the Modrinth project ID in id and version ID in version; unresolved or external files fall back to their SHA-1 identity. The sha1 field remains the integrity hash. A fallback SHA-1 may be passed to GET /public/mod/{id} for Modpacks.ch cross-provider lookup. Only entries with type mod are playable mods.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/%7BprojectIdOrSlug%7D/%7BversionId%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
projectIdOrSlug required | path | string | Modrinth project ID or slug. |
versionId required | path | string | Modrinth version ID. |
Responses
200 JSON object with status, id, name, type, parent, targets, specs, files, installs, plays, refreshed, and notification. object
{
"id": "IIJJKKLL",
"name": "1.0.0",
"type": "release",
"updated": 1710000000,
"status": "success",
"installs": 1200,
"plays": 0,
"refreshed": 1710000000,
"changelog": "Updated mods and configuration.",
"parent": "AABBCCDD",
"notification": "",
"links": [],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": "",
"files": [
{
"id": "m5T5xmUy",
"version": "r4yqxYQl",
"name": "example-mod.jar",
"type": "mod",
"updated": 1710000000,
"path": "mods/",
"url": "https://cdn.modrinth.com/data/ABCDEFGH/versions/QRSTUVWX/example-mod.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"tags": [],
"clientonly": false,
"serveronly": false,
"optional": false
},
{
"id": "IIJJKKLL",
"version": "1.0.0",
"name": "example-pack.mrpack",
"type": "mr-extract",
"updated": 1710000000,
"path": "./",
"url": "https://cdn.modrinth.com/data/AABBCCDD/versions/IIJJKKLL/example-pack.mrpack",
"mirrors": [],
"sha1": "2222222222222222222222222222222222222222",
"size": -1,
"tags": [],
"clientonly": false,
"serveronly": false,
"optional": false
}
]
}GET /public/modrinth/{id}/{versionid}/new Get Modrinth modpack version
Returns a Modrinth modpack version and expands its .mrpack index into the established files manifest.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/238222/%7Bversionid%7D/new'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Modrinth project ID or slug. |
versionid required | path | string | Modrinth version ID. |
Responses
200 JSON object with status, id, name, type, parent, targets, specs, files, installs, plays, refreshed, and notification. object
{
"id": "IIJJKKLL",
"name": "1.0.0",
"type": "release",
"updated": 1710000000,
"status": "success",
"installs": 1200,
"plays": 0,
"refreshed": 1710000000,
"changelog": "Updated mods and configuration.",
"parent": "AABBCCDD",
"notification": "",
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": "",
"files": [
{
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-mod.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"clientonly": false,
"serveronly": false,
"optional": false,
"curseforge": {
"project": "5000",
"file": "6000"
},
"id": 6000,
"name": "example-mod.jar",
"type": "mod",
"updated": 1710000000
}
]
}GET /public/modrinth/{id}/{versionid}/server/{platform} Download Modrinth server installer
Downloads the platform-specific server installer binary for a Modrinth modpack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/238222/%7Bversionid%7D/server/%7Bplatform%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Modrinth project ID or slug. |
versionid required | path | string | Modrinth version ID. |
platform required | path | string | Target platform: linux, mac, freebsd, or windows. |
Responses
200 Binary installer stream. string (binary)
TVoAAA==GET /public/modrinth/{id}/{versionid}/server/{arch}/{platform} Download Modrinth server installer
Downloads the platform-specific server installer binary for a Modrinth modpack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/modrinth/238222/%7Bversionid%7D/server/%7Barch%7D/%7Bplatform%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Modrinth project ID or slug. |
versionid required | path | string | Modrinth version ID. |
arch required | path | string | Optional architecture, such as arm or arm64. |
platform required | path | string | Target platform: linux, mac, freebsd, or windows. |
Responses
200 Binary installer stream. string (binary)
TVoAAA==1 endpoints
Loaders
Get exact loader builds for a Minecraft version.
GET /public/loaders/{mcVersion}/{loader} List loader versions
Returns loader versions available for a Minecraft game version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/loaders/%7BmcVersion%7D/%7Bloader%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
mcVersion required | path | string | Minecraft game version. |
loader required | path | string | Loader type, such as forge, fabric, quilt, or neoforge. |
Responses
200 JSON object with status, art, loaders, id, name, total, and refreshed. ModpackApiDataResponsePayloadLoaderPayload
{
"status": "success",
"art": [
{
"id": 300,
"type": "square",
"updated": 1710000000,
"url": "https://example.com/art.png",
"mirrors": [],
"sha1": "0000000000000000000000000000000000000000",
"size": 1024,
"width": 512,
"height": 512,
"compressed": true
}
],
"loaders": [
{
"id": 47,
"version": "47.2.0",
"game": "minecraft",
"gameVersion": "1.20.1",
"type": "forge"
}
],
"id": 1,
"name": "Forge",
"total": 1,
"refreshed": 1710000000
}11 endpoints
Hytale
Find Hytale projects and their files.
GET /public/hytale/mods/browse/{filter} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/browse/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/browse/{filter}/{secondFilter} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/browse/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/browse/{filter}/{secondFilter}/{thirdFilter} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/browse/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field: popular, updated, new, or featured. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/browse/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field: popular, updated, new, or featured. |
page required | path | string | Optional one-based page number. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/search/{filter} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/search/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/search/{filter}/{secondFilter} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/search/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/search/{filter}/{secondFilter}/{thirdFilter} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/search/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field: popular, updated, new, or featured. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mods/search/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse Hytale mods
Returns a paged list of CurseForge Hytale mods. Filters can include a Hytale build, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First Hytale build, category ID, or sort field. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field: popular, updated, new, or featured. |
page required | path | string | Optional one-based page number. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 7000,
"name": "Example Hytale Mod",
"updated": 1710000000,
"synopsis": "A short Hytale mod summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": [
{
"id": -1,
"name": "Project Page",
"link": "https://www.curseforge.com/hytale/mods/example-hytale-mod",
"type": "curseforge"
}
],
"targets": [
{
"id": null,
"name": "hytale",
"type": "game",
"version": "2026.01",
"updated": 1710000000
}
]
}
],
"page": "1",
"pages": 3
}GET /public/hytale/mod/{id} Get Hytale mod
Returns a Hytale mod record by provider project ID.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/hytale/mod/238222'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | Provider project ID. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, and refreshed. ModpackApiDataResponsePayloadProviderModPayload
{
"id": 5000,
"name": "Example Project",
"type": "release",
"updated": 1710000000,
"synopsis": "A short project summary.",
"description": "## About this project\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": [],
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": null,
"versions": [
{
"id": 6000,
"name": "example-project-1.0.0.jar",
"type": "release",
"updated": 1710000000,
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-project-1.0.0.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"clientonly": false,
"serveronly": null,
"targets": [
{
"id": 40,
"name": "minecraft",
"type": "game",
"version": "1.20.1",
"updated": 1710000000
}
],
"dependencies": [
{
"id": 7000,
"file": null,
"required": true
}
],
"conflicts": null
}
],
"installs": 1200,
"status": "success",
"provider": "curseforge",
"refreshed": 1710000000,
"timings": []
}2 endpoints
FTB
Find Feed The Beast packs and their files.
GET /public/ftb/{id} Get FTB modpack
Returns a modpack record for an FTB pack.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/ftb/238222'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | FTB pack ID. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, provider, and refreshed. ModpackApiDataResponsePayloadModpackPayload
{
"synopsis": "A short pack summary.",
"description": "A longer pack description.",
"art": [
{
"id": 300,
"type": "square",
"updated": 1710000000,
"url": "https://example.com/art.png",
"mirrors": [],
"sha1": "0000000000000000000000000000000000000000",
"size": 1024,
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"versions": [
{
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}
],
"installs": 1200,
"plays": 3400,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"featured": true,
"refreshed": 1710000000,
"notification": "",
"rating": {
"id": -1,
"configured": false,
"verified": false,
"age": 7,
"gambling": false,
"frightening": true,
"alcoholdrugs": false,
"nuditysexual": false,
"sterotypeshate": false,
"language": false,
"violence": true
},
"status": "success",
"released": 1710000000,
"provider": "ftb",
"plays_14d": 120,
"private": false,
"id": 7000,
"name": "Example FTB Pack",
"type": "release",
"updated": 1710000000
}GET /public/ftb/{id}/{versionid} Get FTB version
Returns a version record for an FTB pack version.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/ftb/238222/%7Bversionid%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | FTB pack ID. |
versionid required | path | integer (int32) | FTB version ID. |
Responses
200 JSON object with status, id, name, type, parent, targets, specs, files, installs, plays, and refreshed. ModpackApiDataResponsePayloadVersionPayload
{
"status": "success",
"installs": 1200,
"plays": 3400,
"refreshed": 1710000000,
"changelog": "Updated mods and configuration.",
"parent": 100,
"notification": "",
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"files": [
{
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-mod.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"clientonly": false,
"serveronly": false,
"optional": false,
"curseforge": {
"project": "5000",
"file": "6000"
},
"id": 6000,
"name": "example-mod.jar",
"type": "mod",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}26 endpoints
CurseForge
Browse and search CurseForge projects through Modpacks.ch.
GET /public/curseforge/browse/{filter} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/browse/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/browse/{filter}/{secondFilter} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/browse/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/browse/{filter}/{secondFilter}/{thirdFilter} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/browse/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/browse/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/search/{filter} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/search/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/search/{filter}/{secondFilter} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/search/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/search/{filter}/{secondFilter}/{thirdFilter} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/search/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/search/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse CurseForge modpacks
Returns a paged list of CurseForge modpacks. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, packs, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowsePacksPayload
{
"refreshed": 1710000000,
"status": "success",
"packs": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/browse/{filter} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/browse/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/browse/{filter}/{secondFilter} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/browse/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/browse/{filter}/{secondFilter}/{thirdFilter} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/browse/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/browse/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/browse/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/search/{filter} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/search/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/search/{filter}/{secondFilter} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/search/popular/%7BsecondFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/search/{filter}/{secondFilter}/{thirdFilter} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/search/{filter}/{secondFilter}/{thirdFilter}/{sort} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/mods/search/{filter}/{secondFilter}/{thirdFilter}/{sort}/{page} Browse CurseForge mods
Returns a paged list of CurseForge mods. Filters can include loader, game version, category, sort, and page segments.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/mods/search/popular/%7BsecondFilter%7D/%7BthirdFilter%7D/popular/1'Parameters
| Name | In | Type | Description |
|---|---|---|---|
filter required | path | string | First filter, sort, category, loader, or game version. |
secondFilter required | path | string | Optional second filter. |
thirdFilter required | path | string | Optional third filter. |
sort required | path | string | Optional sort field. |
page required | path | string | Optional page number. |
Responses
200 JSON object with status, mods, page, pages, and refreshed. ModpackApiDataResponsePayloadProviderBrowseModsPayload
{
"refreshed": 1710000000,
"status": "success",
"mods": [
{
"id": 5000,
"name": "Example Project",
"updated": 1710000000,
"synopsis": "A short project summary.",
"type": "release",
"art": [
{
"type": "square",
"url": "https://example.com/art.png",
"mirrors": []
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"tags": [
{
"id": 10,
"name": "tech"
}
],
"provider": "curseforge",
"installs": 1200,
"links": null,
"targets": null
}
],
"page": "1",
"pages": 3
}GET /public/curseforge/{id} Get CurseForge modpack
Returns a modpack record for a CurseForge project. Synopsis is the short CurseForge summary; description is provider-authored Markdown converted from CurseForge HTML and must be treated as untrusted content.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/238222'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | CurseForge project ID. |
Responses
200 JSON object with status, id, name, type, synopsis, description, art, links, authors, versions, installs, provider, and refreshed. ModpackApiDataResponsePayloadModpackPayload
{
"synopsis": "A short pack summary.",
"description": "## About this pack\n\nA longer provider-authored description in **Markdown**.",
"art": [
{
"id": 300,
"type": "square",
"updated": 1710000000,
"url": "https://example.com/art.png",
"mirrors": [],
"sha1": "0000000000000000000000000000000000000000",
"size": 1024,
"width": 512,
"height": 512,
"compressed": true
}
],
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"authors": [
{
"id": 20,
"name": "Example Author",
"type": "team",
"website": "https://example.com",
"updated": 1710000000
}
],
"versions": [
{
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}
],
"installs": 1200,
"plays": 3400,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"featured": true,
"refreshed": 1710000000,
"notification": "",
"rating": {
"id": -1,
"configured": false,
"verified": false,
"age": 7,
"gambling": false,
"frightening": true,
"alcoholdrugs": false,
"nuditysexual": false,
"sterotypeshate": false,
"language": false,
"violence": true
},
"status": "success",
"released": 1710000000,
"provider": "curseforge",
"plays_14d": 120,
"private": false,
"id": 5000,
"name": "Example CurseForge Pack",
"type": "release",
"updated": 1710000000
}GET /public/curseforge/{id}/{versionid} Get CurseForge version
Returns a version record for a CurseForge modpack project file.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/238222/%7Bversionid%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | CurseForge project ID. |
versionid required | path | integer (int32) | CurseForge file ID. |
Responses
200 JSON object with status, id, name, type, parent, targets, specs, files, installs, plays, refreshed, and notification. ModpackApiDataResponsePayloadVersionPayload
{
"status": "success",
"installs": 1200,
"plays": 3400,
"refreshed": 1710000000,
"changelog": "Updated mods and configuration.",
"parent": 100,
"notification": "",
"links": [
{
"id": 30,
"name": "Website",
"link": "https://example.com",
"type": "website"
}
],
"targets": [
{
"version": "1.20.1",
"id": 40,
"name": "minecraft",
"type": "game",
"updated": 1710000000
}
],
"specs": {
"id": -1,
"minimum": 4096,
"recommended": 8192
},
"files": [
{
"version": "1.0.0",
"path": "mods/",
"url": "https://example.com/example-mod.jar",
"mirrors": [],
"sha1": "1111111111111111111111111111111111111111",
"size": 2048,
"tags": [
{
"id": 10,
"name": "tech"
}
],
"clientonly": false,
"serveronly": false,
"optional": false,
"curseforge": {
"project": "5000",
"file": "6000"
},
"id": 6000,
"name": "example-mod.jar",
"type": "mod",
"updated": 1710000000
}
],
"private": false,
"id": 200,
"name": "1.0.0",
"type": "release",
"updated": 1710000000
}GET /public/curseforge/{id}/{versionid}/server/{platform} Download CurseForge server installer
Downloads the platform-specific server installer binary for a CurseForge modpack file.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/238222/%7Bversionid%7D/server/%7Bplatform%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | CurseForge project ID. |
versionid required | path | integer (int32) | CurseForge file ID. |
platform required | path | string | Target platform: linux, mac, freebsd, or windows. |
Responses
200 Binary installer stream. string (binary)
TVoAAA==GET /public/curseforge/{id}/{versionid}/server/{arch}/{platform} Download CurseForge server installer
Downloads the platform-specific server installer binary for a CurseForge modpack file.
Request
Link to endpointcurl --request GET 'https://api.modpacks.ch/public/curseforge/238222/%7Bversionid%7D/server/%7Barch%7D/%7Bplatform%7D'Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | integer (int32) | CurseForge project ID. |
versionid required | path | integer (int32) | CurseForge file ID. |
arch required | path | string | Optional architecture, such as arm or arm64. |
platform required | path | string | Target platform: linux, mac, freebsd, or windows. |
Responses
200 Binary installer stream. string (binary)
TVoAAA==40 schemas
Response fields
Open a type to see the fields an endpoint can return.
ModpackApiDataResponsePayloadTagPayload 2 fields
idunknownnamestring
ModpackApiDataResponsePayloadPingPayload 2 fields
statusstringreplystring
ModpackApiDataResponsePayloadProviderModPayload 16 fields
idunknownnamestringtypestringupdatedinteger (int64)synopsisstringdescriptionstringartarray<ModpackApiDataResponsePayloadProviderArtPayload>linksarray<ModpackApiDataResponsePayloadLinkPayload>authorsarray<ModpackApiDataResponsePayloadProviderAuthorPayload>tagsarray<ModpackApiDataResponsePayloadTagPayload>versionsarray<ModpackApiDataResponsePayloadProviderFilePayload>installsinteger (int32)statusstringproviderstringrefreshedinteger (int64)timingsarray<unknown>
ModpackApiDataResponsePayloadProviderArtPayload 6 fields
typestringurlstringmirrorsarray<string>widthinteger (int32)heightinteger (int32)compressedboolean
ModpackApiDataResponsePayloadLinkPayload 4 fields
idinteger (int32)namestringlinkstringtypestring
ModpackApiDataResponsePayloadProviderFilePayload 15 fields
idunknownnamestringtypestringupdatedinteger (int64)versionstringpathstringurlstringmirrorsarray<string>sha1stringsizeinteger (int32)clientonlybooleanserveronlybooleantargetsarray<ModpackApiDataResponsePayloadProviderTargetPayload>dependenciesarray<ModpackApiDataResponsePayloadDependencyPayload>conflictsarray<ModpackApiDataResponsePayloadDependencyPayload>
ModpackApiDataResponsePayloadProviderTargetPayload 5 fields
idunknownnamestringtypestringversionstringupdatedinteger (int64)
ModpackApiDataResponsePayloadDependencyPayload 3 fields
idunknownfileunknownrequiredboolean
ModpackApiDataResponsePayloadPluginSearchPayload 4 fields
pluginsarray<integer (int32)>totalinteger (int32)limitinteger (int32)refreshedinteger (int64)
ModpackApiDataResponsePayloadModMetadataLookupPayload 2 fields
statusstringmetaModpackApiDataResponsePayloadModMetadataPayload
ModpackApiDataResponsePayloadModMetadataPayload 9 fields
fileIdinteger (int32)namestringfilenamestringsynopsisstringiconstringcurseSlugstringcurseProjectinteger (int32)curseFileinteger (int32)storedinteger (int64)
ModpackApiDataResponsePayloadModSearchPayload 5 fields
modsarray<unknown>totalinteger (int32)limitinteger (int32)termstringrefreshedinteger (int64)
ModpackApiDataResponsePayloadProviderBrowsePacksPayload 5 fields
refreshedinteger (int64)statusstringpacksarray<ModpackApiDataResponsePayloadProviderBrowseCardPayload>pagestringpagesinteger (int32)
ModpackApiDataResponsePayloadProviderBrowseCardPayload 12 fields
idunknownnamestringupdatedinteger (int64)synopsisstringtypestringartarray<ModpackApiDataResponsePayloadArtLightPayload>authorsarray<ModpackApiDataResponsePayloadAuthorPayload>tagsarray<ModpackApiDataResponsePayloadTagPayload>providerstringinstallsinteger (int32)linksarray<ModpackApiDataResponsePayloadLinkPayload>targetsarray<ModpackApiDataResponsePayloadProviderTargetPayload>
ModpackApiDataResponsePayloadArtLightPayload 3 fields
typestringurlstringmirrorsarray<string>
ModpackApiDataResponsePayloadProviderBrowseModsPayload 5 fields
refreshedinteger (int64)statusstringmodsarray<ModpackApiDataResponsePayloadProviderBrowseCardPayload>pagestringpagesinteger (int32)
ModpackApiDataResponsePayloadStatusMessagePayload 2 fields
statusstringmessagestring
ModpackApiDataResponsePayloadBrowsePayload 5 fields
refreshedinteger (int64)statusstringpacksarray<ModpackApiDataResponsePayloadBrowsePackPayload>pagestringpagesinteger (int32)
ModpackApiDataResponsePayloadBrowsePackPayload 10 fields
idstringnamestringproviderstringsynopsisstringtypestringupdatedinteger (int64)artarray<ModpackApiDataResponsePayloadArtLightPayload>authorsarray<ModpackApiDataResponsePayloadAuthorPayload>tagsarray<ModpackApiDataResponsePayloadTagPayload>installsinteger (int32)
ModpackApiDataResponsePayloadChangelogPayload 3 fields
statusstringcontentstringupdatedinteger (int64)
ModpackApiDataResponsePayloadModpackPayload 22 fields
idinteger (int32)namestringtypestringupdatedinteger (int64)synopsisstringdescriptionstringartarray<ModpackApiDataResponsePayloadArtPayload>linksarray<ModpackApiDataResponsePayloadLinkPayload>authorsarray<ModpackApiDataResponsePayloadAuthorPayload>versionsarray<ModpackApiDataResponsePayloadMiniVersionPayload>installsinteger (int32)playsinteger (int32)tagsarray<ModpackApiDataResponsePayloadTagPayload>featuredbooleanrefreshedinteger (int64)notificationstringratingModpackApiDataResponsePayloadRatingPayloadstatusstringreleasedunknownproviderstringplays_14dinteger (int32)privateboolean
ModpackApiDataResponsePayloadArtPayload 10 fields
idinteger (int32)typestringupdatedinteger (int64)urlstringmirrorsarray<string>sha1stringsizeinteger (int32)widthinteger (int32)heightinteger (int32)compressedboolean
ModpackApiDataResponsePayloadMiniVersionPayload 7 fields
idinteger (int32)namestringtypestringupdatedinteger (int64)specsModpackApiDataResponsePayloadRecommendPayloadtargetsarray<ModpackApiDataResponsePayloadTargetPayload>privateboolean
ModpackApiDataResponsePayloadRecommendPayload 3 fields
idinteger (int32)minimuminteger (int32)recommendedinteger (int32)
ModpackApiDataResponsePayloadTargetPayload 5 fields
idinteger (int32)namestringtypestringupdatedinteger (int64)versionstring
ModpackApiDataResponsePayloadRatingPayload 11 fields
idinteger (int32)configuredbooleanverifiedbooleanageinteger (int32)gamblingbooleanfrighteningbooleanalcoholdrugsbooleannuditysexualbooleansterotypeshatebooleanlanguagebooleanviolenceboolean
ModpackApiDataResponsePayloadPackIdListPayload 5 fields
packsarray<integer (int32)>totalinteger (int32)limitinteger (int32)refreshedinteger (int64)statusstring
ModpackApiDataResponsePayloadPopularPacksPayload 7 fields
packsarray<integer (int32)>totalinteger (int32)typestringlimitinteger (int32)statusstringrefreshedinteger (int64)daysinteger (int32)
ModpackApiDataResponsePayloadSearchPayload 5 fields
packsarray<integer (int32)>curseforgearray<integer (int32)>totalinteger (int32)limitinteger (int32)refreshedinteger (int64)
ModpackApiDataResponsePayloadVersionPayload 16 fields
idinteger (int32)namestringtypestringupdatedinteger (int64)statusstringinstallsinteger (int32)playsinteger (int32)refreshedinteger (int64)changelogstringparentinteger (int32)notificationstringlinksarray<ModpackApiDataResponsePayloadLinkPayload>targetsarray<ModpackApiDataResponsePayloadTargetPayload>specsModpackApiDataResponsePayloadRecommendPayloadfilesarray<ModpackApiDataResponsePayloadFilePayload>privateboolean
ModpackApiDataResponsePayloadFilePayload 15 fields
idinteger (int32)namestringtypestringupdatedinteger (int64)versionstringpathstringurlstringmirrorsarray<string>sha1stringsizeinteger (int32)tagsarray<ModpackApiDataResponsePayloadTagPayload>clientonlybooleanserveronlybooleanoptionalbooleancurseforgeModpackApiDataResponsePayloadCurseForgeReferencePayload
ModpackApiDataResponsePayloadCurseForgeReferencePayload 2 fields
projectstringfilestring
ModpackApiDataResponsePayloadVersionModsPayload 16 fields
idinteger (int32)namestringtypestringupdatedinteger (int64)statusstringinstallsinteger (int32)playsinteger (int32)refreshedinteger (int64)changelogstringparentinteger (int32)notificationstringlinksarray<ModpackApiDataResponsePayloadLinkPayload>targetsarray<ModpackApiDataResponsePayloadTargetPayload>specsModpackApiDataResponsePayloadRecommendPayloadfilesstringmodsarray<ModpackApiDataResponsePayloadModMetadataPayload>
ModpackApiDataResponsePayloadLoaderPayload 7 fields
statusstringartarray<ModpackApiDataResponsePayloadArtPayload>loadersarray<ModpackApiDataResponsePayloadLoaderVersionPayload>idinteger (int32)namestringtotalinteger (int32)refreshedinteger (int64)
ModpackApiDataResponsePayloadLoaderVersionPayload 5 fields
idinteger (int32)versionstringgamestringgameVersionstringtypestring