API Documentation

Authentication

Read endpoints are public — no key required. Write endpoints require an API key with the write scope.

Pass your key via the Authorization header or as a query param:

Authorization: Bearer mvk_your_key_here
# or
GET /api/v1/mods?api_key=mvk_your_key_here

Get your API key from Creator → API Keys.

Rate limits

Unauthenticated: 60 requests/minute. With API key: 600 requests/minute. Rate limit headers are included in every response.

Endpoints

GET /api/v1/mods

List mods with filtering and pagination.

GET /api/v1/mods?q=storage&category=Technology&mc_version=1.21.1&loader=fabric&sort=downloads&page=1&limit=20

Sort options: downloads, newest, updated, rating, name. Max limit: 50.

GET /api/v1/mods/:slug

Get full details for a single mod including tags, dependencies, and links.

GET /api/v1/mods/my-awesome-mod

GET /api/v1/mods/:slug/versions

List all approved versions for a mod with download URLs.

GET /api/v1/mods/my-awesome-mod/versions

GET /api/v1/mods/:slug/versions/:versionId/download

Download a specific version. Redirects to the file. Increments download counter.

GET /api/v1/mods/my-awesome-mod/versions/42/download

GET /api/v1/search

Search across mods, creators, and modpacks simultaneously.

GET /api/v1/search?q=storage+tech

GET /api/v1/modpacks

List public modpacks.

GET /api/v1/modpacks/:slug

Get modpack details with full mod list and version pins.

GET /api/v1/modpacks/:slug/manifest.json

Download a launcher-importable modpack manifest. Compatible with Prism Launcher, MultiMC, and other launchers that support CurseForge-style manifests.

GET /api/v1/modpacks/my-pack/manifest.json

The manifest includes direct download URLs for each mod file so launchers can auto-install everything.

GET /api/v1/creators/:username

Get a creator's public profile, stats, and mod list.

GET /api/v1/creators/mycreator

GET /api/v1/mc-versions

List known Minecraft versions with compatibility status (supported, old, ancient).

Response format

All responses are JSON. List endpoints return a data array. Paginated endpoints include a pagination object:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 142,
    "pages": 8
  }
}

Importing a modpack

To install a ModVault modpack in Prism Launcher or MultiMC:

• Download the manifest.json from the modpack page or API
• In your launcher, choose Import → From file
• Select the manifest.json file
• The launcher will automatically download all mod files using the embedded download URLs

Example: fetch latest version of a mod

const res = await fetch('https://modvault.snugglesmp.com/api/v1/mods/my-mod/versions');
const { data } = await res.json();
const latest = data.find(v => v.is_latest);
console.log(latest.download_url);