---
title: "Get Map Leaderboard"
method: GET
path: "/api/v3/completions/{code}"
tags: ["Completions"]
---

# Get Map Leaderboard

`GET /api/v3/completions/{code}`

Retrieve the leaderboard for a given map, including ranks and medals.

## Path parameters

- `code` string, required

## Query parameters

- `page_size` integer
- `page_number` integer

## Response `200`

Request fulfilled, document follows

- CompletionResponse[]
  - `code` string, required
  - `user_id` integer, required
  - `name` string, required
  - `also_known_as` string, nullable
  - `time` number, required
  - `screenshot` string, required
  - `video` string, nullable
  - `completion` boolean, required
  - `verified` boolean, required
  - `rank` integer, nullable
  - `medal` 'Gold' | 'Silver' | 'Bronze' | 'null', nullable
  - `map_name` string, required
  - `difficulty` 'Easy -' | 'Easy' | 'Easy +' | 'Medium -' | 'Medium' | 'Medium +' | 'Hard -' | 'Hard' | 'Hard +' | 'Very Hard -' | 'Very Hard' | 'Very Hard +' | 'Extreme -' | 'Extreme' | 'Extreme +' | 'Hell', required
  - `message_id` integer, required
  - `legacy` boolean, required
  - `legacy_medal` 'Gold' | 'Silver' | 'Bronze' | 'null', nullable
  - `suspicious` boolean, required
  - `total_results` integer, nullable
  - `upvotes` integer
  - `id` integer, nullable

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/versions/6db12055b305/schema)