---
title: "Returns the latest records."
method: GET
path: "/records"
tags: ["Records"]
---

# Returns the latest records.

`GET /records`

## Query parameters

- `top` boolean
- `ranked` boolean
- `player` union
  - string
  - string — a SteamID
- `server` union
  - string
  - integer
- `map` union
  - string
  - integer
- `course` string
- `mode` 'vanilla' | 'classic'
- `has_teleports` boolean
- `max_rank` integer
- `sort_by` 'submission-date' | 'time'
- `sort_order` 'ascending' | 'descending'
- `limit` integer
- `offset` integer

## Response `200`

- PaginatedRecord
  - `total` integer, required — The total number of values available for fetching. Different endpoints have different hard-limits on how many values they will return at a time. They usually also have an `offset` query parameter you can use to fetch the next set of values. You can use `total` to infer when you can stop making requests.
  - `values` object[], required — The values returned for this request.
    - `id` string, uuid, required
    - `player` PlayerInfo, required
      - `id` string, required — a SteamID
      - `name` string, required — The player's name on Steam.
    - `server` ServerInfo, required
      - `id` integer, required — The server's ID.
      - `name` string, required — The server's name.
    - `map` MapInfo, required
      - `id` integer, required — The map's ID.
      - `name` string, required — The map's name.
    - `course` CourseInfo, required
      - `id` integer, required — The course's ID.
      - `name` string, required — The course's name.
      - `nub_tier` 'very-easy' | 'easy' | 'medium' | 'advanced' | 'hard' | 'very-hard' | 'extreme' | 'death' | 'unfeasible' | 'impossible', required
      - `pro_tier` 'very-easy' | 'easy' | 'medium' | 'advanced' | 'hard' | 'very-hard' | 'extreme' | 'death' | 'unfeasible' | 'impossible', required
      - `state` 'unranked' | 'pending' | 'ranked', required
    - `mode` 'vanilla' | 'classic', required
    - `styles` string[], required
    - `teleports` integer, required
    - `time` number, double, required — Time in seconds.
    - `nub_rank` integer, nullable
    - `nub_points` number, double, nullable
    - `pro_rank` integer, nullable
    - `pro_points` number, double, nullable
    - `replay_available` boolean, required

## Other responses

- `400` — invalid query parameters

---

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