---
title: "Retrieve featured maps for each gamemode, refreshed every hour"
method: GET
path: "/v1/maps/featured"
tags: ["Maps"]
---

# Retrieve featured maps for each gamemode, refreshed every hour

`GET /v1/maps/featured`

## Request

- Base URL: `https://api.momentum-mod.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.momentum-mod.org/v1/maps/featured`
- Auth: HTTP bearer

## Response `200`

List of featured maps grouped by gamemode. Each entry contains up to 3 maps selected from different tier (difficulty) ranges.

- FeaturedMapsForGamemodeDto[]
  - `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required
  - `mapIDs` number[], required: IDs of the featured maps

---

[API](https://skmtc.dev/momentum-mod/apis/momentum-mod-api.md) - [All operations](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/llms.txt) - [OpenAPI document](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/revisions/0a88cfbbcc65?raw)
