---
title: "Retrieve a calendar of upcoming and past competitions."
method: GET
path: "/competitions"
tags: ["Competitions"]
---

# Retrieve a calendar of upcoming and past competitions.

`GET /competitions`

## Request

- Base URL: `https://api.atletiek.nu/v1`
- URL: `https://api.atletiek.nu/v1/competitions`
- Auth: none required

## Query parameters

- `status` 'Upcoming' | 'Completed' | 'Registration_Open'
- `year` integer

## Response `200`

A list of competitions.

- Competition[]
  - `id` string
  - `name` string: The official name of the competition (e.g., 'ASICS NK Atletiek 2025').
  - `date` string, date: The start date of the competition.
  - `country` string
  - `city` string
  - `location` string: Venue or stadium where the competition is held.
  - `organizer` string: The organizing club or body.
  - `start_time` string, date-time
  - `end_time` string, date-time
  - `participants` integer
  - `registration_status` 'Open' | 'Closed' | 'Full' | 'Not_Applicable': Current status of athlete registration.
  - `start_date_registrations` string, date-time
  - `end_date_registrations` string, date-time
  - `results_url` string, url: Direct link to the public results page for the competition.
  - `description` string: HTML-supported description.

## Changes

> 13 revisions in range; 1 not diffed.

- **2026-07-14** `cd49a90e4266`: 6 info
  - added the new optional `query` request parameter `status`
  - added the new optional `query` request parameter `year`
  - added the optional property `items/location` to the response with the `200` status
  - added the optional property `items/organizer` to the response with the `200` status
  - …2 more
- **2026-06-12** `986d9d3f02e9`: 1 info
  - endpoint added
- **2026-06-12** `8c9189a8cd60`: 3 warning
  - removed the optional property `items/address` from the response with the `200` status
  - removed the optional property `items/email` from the response with the `200` status
  - removed the optional property `items/phone` from the response with the `200` status

[Operation history](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/changes/competitions/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)