---
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}`

## Request

- Base URL: `https://api.atletiek.nu/v1`
- URL: `https://api.atletiek.nu/v1/top-lists/{discipline}`
- Auth: none required
- TypeScript: <https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/docs/top-lists/:discipline/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.

## Changes

> 13 revisions in range; 1 not diffed.

- **2026-07-14** `cd49a90e4266`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/changes/top-lists/:discipline/get.md)

---

[API](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api.md) - [All operations](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/revisions/cd49a90e4266?raw)