How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Curse

Curse Mods API

The Mods API from Curse — 19 operation(s) for mods.

Documentation Provider Profile APIs.io OpenAPI GitHub

Curse Mods API is one of 7 APIs that Curse publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include MODS. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 19 operations across 19 paths, and defines 79 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against a single base URL, https://api.curseforge.com.

19 operations 19 paths 79 schemas 8 GET11 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://api.curseforge.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Curse Mods API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (API_KEY). By default, every request must be authenticated.

  • API_KEY — The API key can be generated in the CurseForge for Studios [developer console](https://console.curseforge.com/).

Paths & Operations 19

Across 19 paths, the API surfaces 19 operations — 8 GET, 11 POST. Each is listed below with its method, path, parameters, and response codes.

Mods 19
GET
/v1/mods/search
Get all mods that match the search criteria.
Search Mods 20 params → 200500400
POST
/v1/mods/app-search
App Mods Search body → 200500400
GET
/v1/mods/{modId}
Get a single mod.
Get Mod 1 param → 200500404
POST
/v1/mods/get-mods-by-ids
Get a list of mods belonging the the same game.
Get Mods body → 200500400
POST
/v1/mods
Get a list of mods belonging the the same game.
Get Mods2 body → 200500400
POST
/v1/mods/featured
Get a list of featured, popular and recently updated mods.
Get Featured Mods body → 200500400404
GET
/v1/mods/{modId}/description
Get the full description of a mod in HTML format.
Get Mod Description 5 params → 200500404
GET
/v1/mods/app-highlights
Mods_GetAppModHighlights 1 param → 200404
POST
/v1/mods/highlights
Get Mod Highlights body → 200500
POST
/v3/mods/highlights
Get Mod Highlights2 body → 200500
GET
/v3/mods
Mods_GetById 1 param → 200
GET
/v2/mods/app-highlights
Mods_GetAppModHighlights2 1 param → 200404
POST
/v2/mods/highlights
Get Mod Highlights22 body → 200500
GET
/v2/mods/search
Get all mods that match the search criteria.
Search Mods2 20 params → 200500400
POST
/v2/mods/community-picks-candidates
Mods_GetCommunityPicksCandidates body → 200404
POST
/v2/mods/app-search
App Mods Search2 body → 200500400
GET
/v2/mods/{modId}
Get a single mod.
Get Mod2 1 param → 200500404
POST
/v2/mods/get-mods-by-ids
Get a list of mods belonging the the same game.
Get Mods22 body → 200500400
POST
/v2/mods/featured
Get a list of featured, popular and recently updated mods.
Get Featured Mods2 body → 200500400404

Schemas 79

The contract defines 79 schemas that model the data the API accepts and returns. The most detailed are Mod (34 properties), BaseModDto (32 properties), File (27 properties), SearchModsParameters (19 properties). Each schema is shown below with its type and property counts.

HighlightsModDto
object
7 properties
Search_Mods_Response
object
2 properties
ApiResponseOfListOfModDto
object
1 property
FileRelationType
integer
1 = EmbeddedLibrary 2 = OptionalDependency 3 = RequiredDependency 4 = Tool 5 = Incompatible 6 = Include
FeaturedModsResponseOfModDto
object
3 properties
ApiResponseOfListOfModDto2
object
1 property
AppHighlightsResponse2
FileDependency
object
2 properties
GalleryItem
object
7 properties
Mod
object
34 properties
ModAsset
object
6 properties
AppCarouselItem
object
8 properties
ModLoaderType
integer
0 = Any 1 = Forge 2 = Cauldron 3 = LiteLoader 4 = Fabric 5 = Quilt 6 = NeoForge
ThemePage
object
5 properties
DestinationType
integer
1 = Mod 2 = Themepage
ModAuthor
object
4 properties
ApiResponseOfFeaturedModsResponseOfModDto2
object
1 property
RatingScore
integer
0 = NotEnoughReviews 1 = OverwhelminglyPositive 2 = VeryPositive 3 = Positive 4 = MostlyPositive 5 = Mixed 6 = MostlyNegative 7 = Negative 8 = VeryNegative 9 =…
SortOrder
string
ShelfType
integer
0 = Category 1 = Generated 2 = Custom 3 = Banner
ApiResponseOfAppHighlightsResponse
object
1 property
ApiResponseOfHomepageHighlightsResponse
object
1 property
SocialLink
object
2 properties
GetExpandedModsByIdsListRequestBody
Shelf
object
7 properties
ApiResponseOfModDto
object
1 property
CookerInfo
object
2 properties
GameShelf2
GetHighlightsFeaturedRequest
FileHash
object
2 properties
FileReleaseType
integer
1 = Release 2 = Beta 3 = Alpha
FileStatus
integer
1 = Processing 2 = ChangesRequired 3 = UnderReview 4 = Approved 5 = Rejected 6 = MalwareDetected 7 = Deleted 8 = Archived 9 = Testing 10 = Released 11 = ReadyF…
ClientFeaturedProjectTag
integer
0 = None 1 = Sponsored 2 = HiddenGem 3 = Popular
Category
object
11 properties
QueryParams
object
5 properties
GetFeaturedModsRequestBody
BaseModDto
object
32 properties
HomepageHighlightsResponse2
object
3 properties
HighlightsFilters
object
10 properties
ServerAffiliation
object
7 properties
ModDto2
ModPremiumTypeEnum
integer
0 = All 1 = Premium 2 = Free
FileModule
object
2 properties
ItemLayout
integer
0 = Default 1 = SaleView 2 = SmallSaleView
AffiliationServiceType
integer
1 = Bisect
File
object
27 properties
ApiResponseOfHomepageHighlightsResponse3
object
1 property
GetFeaturedModsRequestBase
object
2 properties
ApiResponseOfHomepageHighlightsResponse2
object
1 property
CarouselItem
object
8 properties
ModStatus
integer
1 = New 2 = ChangesRequired 3 = UnderSoftReview 4 = Approved 5 = Rejected 6 = ChangesMade 7 = Inactive 8 = Abandoned 9 = Deleted 10 = UnderReview
AppHighlightsResponse
SortableGameVersion
object
5 properties
FileIndex
object
6 properties
SearchModsPostRequest
ModDto
GalleryItemType
integer
0 = None 1 = Screenshot 2 = EmbeddedVideo
ModsSearchSortField
integer
1 = Featured 2 = Popularity 3 = LastUpdated 4 = Name 5 = Author 6 = TotalDownloads 7 = Category 8 = GameVersion 9 = EarlyAccess 10 = FeaturedReleased 11 = Rele…
SearchModsParameters
object
19 properties
HomepageHighlightsResponse3
object
10 properties
CommunityPicksCandidatesRequests
object
3 properties
SocialLinkType
integer
1 = Mastodon 2 = Discord 3 = Website 4 = Facebook 5 = Twitter 6 = Instagram 7 = Patreon 8 = Twitch 9 = Reddit 10 = Youtube 11 = TikTok 12 = Pinterest 13 = Gith…
ApiResponseOfAppHighlightsResponse2
object
1 property
ApiResponseWithPaginationOfListOfModDto
object
2 properties
ModLinks
object
4 properties
Destination
object
2 properties
HashAlgo
integer
1 = Sha1 2 = Md5
ShelfContent
object
3 properties
GameShelf
Get_Mod_Response
object
1 property
RatingDetails
object
4 properties
ApiResponseOfFeaturedModsResponseOfModDto
object
1 property
String_Response
object
1 property
HomepageHighlightsResponse
object
8 properties
Pagination
object
4 properties
GetModsByIdsListRequestBody
object
1 property
FeaturedModsResponseOfModDto2
object
3 properties
GameShelfBase
object
4 properties
AppHighlightsResponseBase
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

curse-mods-api-openapi.yml Raw ↑

Other APIs Curse publishes across the network.

Curse Categories API
AE Profile APIs.io
Curse Files API
AE Profile APIs.io
Curse Fingerprints API
AE Profile APIs.io
Curse Games API
AE Profile APIs.io
Curse Minecraft API
AE Profile APIs.io
Curse Subscriptions API
AE Profile APIs.io
#MODS
← Back to C APIs
API Details
ID
curse:curse-mods-api
Base URL
https://api.curseforge.com
Docs
https://docs.curseforge.com/rest-api/
Provider
Curse
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=curse-mods-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/curse-mods-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Curse Mods API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.