Mods & Plugins

Search and install mods and plugins from CurseForge and Modrinth.

Requires mods (Premium or addon) or Premium plan

Search Mods

GET/servers/:id/mods

Search mods/plugins from CurseForge or Modrinth.

Query Parameters

Name	Type	Required	Description
`provider`	string	No	curseforge or modrinth (default: curseforge)
`type`	string	No	mods or plugins (default: mods)
`search`	string	No	Search query
`gameVersion`	string	No	Filter by game version
`modLoader`	number	No	Mod loader ID (CurseForge only)
`page`	number	No	Page (default: 0)
`pageSize`	number	No	Items per page, max 50 (default: 20)

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/mods?provider=modrinth&type=plugins&search=essentials&pageSize=10" \
  -H "Authorization: Bearer rsk_your_key"

Install Mod

POST/servers/:id/mods

Install a mod or plugin on the server.

Body Parameters

Name	Type	Required	Description
`provider`	string	Yes	modrinth or curseforge
`modId`	string \| number	Yes	Mod ID from provider
`fileId`	string \| number	Yes	Release file ID
`type`	string	No	mods or plugins (default: mods)

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/mods" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "modrinth",
    "modId": "abc123",
    "fileId": "ver_456",
    "type": "plugins"
  }'

Error Codes

HTTP	Code	Description
403	`ADDON_REQUIRED`	Mods addon or Premium required
403	`DISTRIBUTION_RESTRICTED`	Mod does not allow third-party downloads
404	`NOT_FOUND`	Mod or file not found
500	`UPLOAD_FAILED`	Upload to server failed