---
title: "Returns a paginated list of a leaderboard's runs. Warning: if the leaderboard itself doesn't exist, this endpoint willreturn a 0 length PaginatedResponseDto."
method: GET
path: "/v1/maps/{mapID}/leaderboard"
tags: ["Maps"]
---

# Returns a paginated list of a leaderboard's runs. Warning: if the leaderboard itself doesn't exist, this endpoint willreturn a 0 length PaginatedResponseDto.

`GET /v1/maps/{mapID}/leaderboard`

## 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/{mapID}/leaderboard`
- Auth: HTTP bearer

## Path parameters

- `mapID` number, required

## Query parameters

- `skip` number
- `take` number
- `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required
- `trackType` 0 | 1 | 2
- `trackNum` number
- `style` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
- `filter` '1;1' | '1;0' | '2;1' | '2;0' | '3;1' | '3;0' | '4;1' | '4;0' | '5;1' | '5;0' | '6;1' | '6;0' | '7;1' | '7;0' | '8;1' | '8;0' | '9;1' | '9;0' | '10;1' | '10;0' | '11;1' | '11;0' | '12;1' | '12;0' | '13;1' | '13;0' | '14;1' | '14;0' | '15;1' | '15;0' | '16;1' | '16;0' | '17;1' | '17;0' | '18;1' | '18;0' | '19;1' | '19;0' | '20;1' | '20;0' | '21;1' | '21;0' | '22;1' | '22;0' | '23;1' | '23;0' | '24;1' | '24;0' | '25;1' | '25;0' | '26;1' | '26;0' | '27;1' | '27;0' | '28;1' | '28;0' | '29;1' | '29;0' | '30;1' | '30;0' | '31;1' | '31;0' | '32;1' | '32;0' | '33;1' | '33;0' | '34;1' | '34;0' | '35;1' | '35;0' | '36;1' | '36;0' | '37;1' | '37;0' | '38;1' | '38;0' | '39;1' | '39;0' | '40;1' | '40;0' | '41;1' | '41;0' | '42;1' | '42;0' | '43;1' | '43;0' | '44;1' | '44;0' | '45;1' | '45;0' | '46;1' | '46;0' | '47;1' | '47;0' | '48;1' | '48;0' | '49;1' | '49;0' | '50;1' | '50;0' | '51;1' | '51;0' | '52;1' | '52;0' | '53;1' | '53;0' | '54;1' | '54;0' | '55;1' | '55;0' | '56;1' | '56;0' | '57;1' | '57;0' | '58;1' | '58;0' | '59;1' | '59;0' | '60;1' | '60;0' | '61;1' | '61;0' | '62;1' | '62;0' | '63;1' | '63;0' | '64;1' | '64;0' | '65;1' | '65;0' | '66;1' | '66;0' | '67;1' | '67;0' | '68;1' | '68;0' | '69;1' | '69;0' | '70;1' | '70;0' | '71;1' | '71;0' | '72;1' | '72;0' | '73;1' | '73;0' | '74;1' | '74;0' | '75;1' | '75;0' | '76;1' | '76;0' | '77;1' | '77;0' | '78;1' | '78;0' | '79;1' | '79;0' | '80;1' | '80;0' | '81;1' | '81;0' | '82;1' | '82;0' | '83;1' | '83;0' | '84;1' | '84;0' | '85;1' | '85;0' | '86;1' | '86;0' | '87;1' | '87;0' | '88;1' | '88;0' | '89;1' | '89;0' | '90;1' | '90;0'
- `userIDs` string
- `steamIDs` string

## Response `200`

The found leaderboard's runs

## Other responses

- `404`: When the map doesn't exist
- `409`: When filtering by 'friends', the user's friend list is private
- `410`: When the filtering by 'around', and the user doesn't have a PB
- `503`: When filtering by 'friends', and Steam fails to return the user's friends list (Tuesdays lol)

---

[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)
