---
title: "List Races"
method: GET
path: "/races"
---

# List Races

`GET /races`

## Request

- Base URL: `https://safefamilyapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://safefamilyapp.com/races`
- Auth: HTTP bearer

Published races, newest event first, with finisher counts. ``?all=true`` (admin) lists every race.

## Query parameters

- `all` boolean

## Response `200`

Successful Response

- RaceSummary[]
  - `race_id` string, required
  - `event_id` string, required
  - `event_name` string, required
  - `event_date` string, date, required
  - `course_name` string, required
  - `distance_km` number, required
  - `elevation_gain_m` number, required
  - `has_gpx` boolean
  - `scoring_version` string, required
  - `measurement_version` string, nullable
  - `measurement_status` string, nullable
  - `published_at` string, date-time, nullable
  - `is_published` boolean
  - `is_demo` boolean
  - `finisher_count` integer, nullable
  - `event_location` string, nullable
  - `event_country` string, nullable
  - `organizer_display` string, nullable
  - `organizer_website` string, nullable
  - `elevation_loss_m` number, nullable
  - `is_vertical` boolean
  - `listing_status` string
  - `is_listed` boolean
  - `calculator_only` boolean
  - `source_url` string, nullable
  - `edition_year` integer, nullable
  - `review_status` string
  - `review_flags` object[], nullable
  - `auto_verify_at` string, date-time, nullable
  - `reviewed_at` string, date-time, nullable
  - `reviewed_by` string, nullable
  - `review_note` string, nullable
  - `publish_attested_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/safefamilyapp/apis/otri-api.md) · [All operations](https://skmtc.dev/safefamilyapp/apis/otri-api/llms.txt) · [OpenAPI document](https://skmtc.dev/safefamilyapp/apis/otri-api/revisions/d07bb03cb836?raw)