---
title: "Leaderboard"
method: GET
path: "/leaderboards"
---

# Leaderboard

`GET /leaderboards`

Retrieves leaderboard information for one (or more) contracts

## Query parameters

- `platforms` string, required
- `publicIds` string, required

## Response `200`

200

- object
  - `contractIds` string[]
  - `uniqueContractNames` string[]
  - `uniqueContractLocations` string[]
  - `entries` object[]
    - `playerId` string
    - `playerName` string
    - `compositeRank` integer
    - `platformRank` integer
    - `platform` string
    - `elapsedTime` string
    - `totalScore` integer
    - `detailedScore` object
      - `silentAssassin` boolean
      - `starCount` integer
      - `objectivesCompleted` boolean
      - `noNoticedKills` boolean
      - `noBodiesFound` boolean
      - `neverSpotted` boolean
      - `noRecordings` boolean
      - `timeBonus` integer
      - `nonTargetKillCount` integer
      - `nonTargetKillScore` integer
    - `vr` boolean
    - `playstyleInternal` unknown
    - `playstyle` unknown
  - `accessTime` string
  - `failedContractIds` unknown[]
    - unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/hitmaps/apis/hitmaps-ioi-api.md) · [All operations](https://skmtc.dev/hitmaps/apis/hitmaps-ioi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hitmaps/hitmaps-ioi-api/revisions/e284b6402e24/schema)