---
title: "Retrieve all users."
method: GET
path: "/users"
tags: ["Users"]
---

# Retrieve all users.

`GET /users`

## Request

- Base URL: `https://api.atletiek.nu/v1`
- URL: `https://api.atletiek.nu/v1/users`
- Auth: HTTP bearer

## Response `200`

A list of users.

- User[]
  - `id` string
  - `first_name` string
  - `last_name` string
  - `nationality` Nationality: A nationality.
    - `iso` string: ISO country code.
    - `description` string
    - `flag` string, url: URL to the flag image.
  - `club` Club: An athletics club.
    - `id` string
    - `name` string
    - `short_name` string
    - `country` string
    - `city` string
    - `email` string, email

## Changes

> 13 revisions in range; 1 not diffed.

- **2026-06-12** `986d9d3f02e9`: 1 info
  - endpoint added
- **2026-06-12** `8c9189a8cd60`: 2 warning
  - removed the optional property `items/birth_date` from the response with the `200` status
  - removed the optional property `items/email` from the response with the `200` status

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