Hyrox Result API

Built for HYROX developers

The HYROX results API your product can ship on

Seasons, events, division results, athlete search, station splits, and precomputed stats. One versioned JSON API with a clear OpenAPI contract and predictable responses.

Get API access Read the docs

Versioned REST API · OpenAPI 3 · Bearer authentication · Catalog and live resolution

Seasons Events Divisions Results Splits Stats Simulator

Try the API before you subscribe

Pick an endpoint, hit Try it out, and see the exact JSON your app would receive. Responses below are mocked for the demo.

GET

Response
200 OK

Press Try it out to run the request.

Mocked responses for illustration. Explore the full OpenAPI spec

What you can build

Skip the scraping and go straight to the product. Here are three things teams ship on day one.

Athlete profile

Show any athlete's full HYROX history

Search by name, then pull race detail, result history, and station splits for a complete profile page.

{
  "data": {
    "name": "A. de Vries",
    "division": "HYROX PRO",
    "total_time_ms": 4021000,
    "splits": { "skiErg_time_ms": 298000 }
  }
}
Event stats dashboard

Division benchmarks by gender and age

One request returns per station medians for an event, bucketed by division, gender, and age group.

{
  "division_key": "HYROX PRO",
  "sex": "M",
  "age_group": "30-34",
  "total_time": { "median_ms": 4098500 }
}
Race simulator and pacing

Know where you stand before race day

Pull percentile benchmarks per division so athletes can set target splits and pacing plans.

{
  "division": "HYROX",
  "sex": "M",
  "percentiles": {
    "p50": { "total_time_ms": 4620000 }
  }
}

See every field in the documentation or explore the OpenAPI spec.

Everything HYROX apps need

Purpose built endpoints from season discovery to simulator benchmarks. Integrate once and focus on your product.

Seasons and calendar

Browse seasons and list events with filters for season, country, and date range. Power race finders and event discovery.

Events and divisions

Resolve events by slug, list divisions, and pull result tables for leaderboards, exports, and analytics.

Athletes

Search by name, load race detail, fetch result history, and retrieve station splits for training and post race analysis.

Stats and benchmarks

Division level statistics and race simulator benchmarks with medians by gender and age group.

Catalog or live

Responses include meta.data_source so you know whether rows came from synced catalog data or live resolution.

OpenAPI and interactive docs

Contract first integration with /api/v1/openapi.yaml and Swagger UI at /docs.

Built for real products

Whether you ship leaderboards, training tools, or analytics, the API covers the full HYROX data model.

Leaderboards and event apps

Division results, rankings, and finish times for live and post race experiences across the full HYROX calendar.

Athlete and training tools

Search athletes, pull split times, and compare station performance against field medians.

Analytics and benchmarking

Precomputed stats by division, gender, and age group for simulators, pacing tools, and performance dashboards.

Core endpoints

A focused surface area. Every route documented in OpenAPI.

Full documentation Swagger UI
Method Endpoint Description
GET /v1/seasons List all HYROX seasons
GET /v1/events List events with season and country filters
GET /v1/divisions/{id}/results Paginated division results and rankings
GET /v1/athletes/search Search athletes by name
GET /v1/athletes/{id}/splits Station split times for a race
GET /v1/stats/divisions/{id} Precomputed stats by division, gender, and age group
GET /v1/simulator/benchmarks Race simulator benchmark data

How it works

  1. Subscribe Create an account and activate your plan with secure checkout.
  2. Create a token Issue a personal access token from your dashboard.
  3. Call the API Send Authorization: Bearer … on each request.
  4. Ship Integrate with your app using the OpenAPI contract.

Common questions

Do I need a subscription to read the docs?
Documentation and the OpenAPI spec are free on the website. Calling protected API routes requires an account, active subscription, and bearer token.
How fresh is the data?
The catalog is synced continuously across the HYROX calendar. Athlete search and detail can resolve live when needed. Every response tells you the source in meta.data_source.
What are the rate limits?
Each plan has a per minute request limit. Exceeding it returns 429 with a Retry-After header. Check your limit at GET /api/user.

Start building on HYROX data today

Subscribe in minutes. Cancel anytime from your account.

Start building View pricing