---
title: "Get List of Athletes"
method: GET
path: "/athletes"
tags: ["Athletes"]
---

# Get List of Athletes

`GET /athletes`

This API returns the list of all athletes.

## Query parameters

- `jersey` string
- `first_name` string
- `last_name` string
- `force_units` 'metric' | 'imperial'

## Response `200`

List of all athletes

- object[]
  - `id` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `gender` string, nullable, required
  - `jersey` string
  - `nickname` string
  - `height` number
  - `weight` number
  - `date_of_birth` integer
  - `date_of_birth_date` string, required
  - `velocity_max` number
  - `acceleration_max` number
  - `heart_rate_max` number
  - `player_load_max` number
  - `image` string
  - `image_url` string
  - `icon` string
  - `stroke_colour` string
  - `fill_colour` string
  - `trail_colour_start` string
  - `trail_colour_end` string
  - `is_synced` integer
  - `is_deleted` integer
  - `is_demo` boolean
  - `created_at` string
  - `modified_at` string
  - `tag_list` string[]
  - `tags` object[]
    - `id` string
    - `tag_type_id` string
    - `name` string
    - `tag_type_name` string
    - `tag_name` string
  - `current_team_id` string
  - `max_player_load_per_minute` integer
  - `position` string, required
  - `position_id` string
  - `position_name` string, required
  - `team_history` object[]
    - `team_id` string, required
    - `athlete_id` string, required
    - `start_time` integer, required
    - `end_time` integer, required
    - `current` boolean, required

## Other responses

- `401` — Unauthenticated

---

[API](https://skmtc.net/catapultsports/apis/openfield-connect-v6-api.md) · [All operations](https://skmtc.net/catapultsports/apis/openfield-connect-v6-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catapultsports/openfield-connect-v6-api/revisions/b68eadaba68c/schema)