Get Mods

GET 
/games/:game-id/mods

Get all mods for the corresponding game. Successful request will return an array of Mod Objects. We recommended reading the filtering documentation to return only the records you want.

info

If the parent game has platform filtering enabled, this endpoint supports the targeting a platform request header to return mods that have been approved for the requested platform. If you are a member of the parent game team, please see the platform_status filter for this endpoint above on how you can retrieve pending mods.

Request

Sorting filters

Parameters

name string

Sort by name in alphabetical order. For example _sort=name would return mods from A-Z.

date_live string

Sort by the date they went live. For example _sort=-date_live would return the most recently live mods.

date_updated string

Sort by the date they were last updated. For example _sort=-date_updated would return the most recently updated mods.

submitted_by string

Sort by the creators ID. For example _sort=submitted_by would return mods from creators who have been registered the longest.

downloads_today string

Sort by the number of downloads in the last 24hours. For example _sort=-downloads_today would return the most popular mods from the last 24hours based on the number of mod downloads.

downloads_total string

Sort by the total number of downloads. For example _sort=-downloads_total would return the most popular mods based on the number of downloads.

subscribers_total string

Sort by the total number of subscribers. For example _sort=-subscribers_total would return the most popular mods based on number of subscribers.

ratings_weighted_aggregate string

Sort by their calculated rating (thumbs up / down received). For example _sort=-ratings_weighted_aggregate would return the highest rated mods.

See here for more details about using the _sort query parameter.

Error Codes

Status Code	Error Ref	Description
403	15025	The authenticated user has applied an admin-only filter or value to the request, and is not an administrator for this game.

See here for more details about errors.

Responses

200

Successful Request

403

The authenticated user has applied an admin-only filter or value to the request, and is not an administrator for this game.