---
title: "Get national top-list data for a specific discipline and category."
method: GET
path: "/top-lists/{discipline}"
tags: ["Top Lists"]
---

# Get national top-list data for a specific discipline and category.

`GET /top-lists/{discipline}`

## Path parameters

- `discipline` string, required

## Query parameters

- `category` string, required

## Response `200`

A list of ranked athletes and their top performances.

- TopListEntry[]
  - `position` integer — The athlete's rank in the list.
  - `athlete_id` string
  - `name` string
  - `club` string
  - `best_performance` Performance — A recorded result or personal best.
    - `discipline` string — The specific discipline (e.g., "400m Hurdles").
    - `performance` string — The recorded performance (time or distance).
    - `unit` 'sec' | 'm' | 'cm' | 'points'
    - `date` string, date
    - `location` string — Location where the performance was achieved.

---

[API](https://skmtc.net/athletics-app/apis/atletiek-nu-competition-data-api.md) · [All operations](https://skmtc.net/athletics-app/apis/atletiek-nu-competition-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athletics-app/atletiek-nu-competition-data-api/versions/cd49a90e4266/schema)