Developer API

RaceHero has a REST API that allows developers to integrate with their own processes. Look for more functionality in the future:

Organizations

For race organizations to integrate RaceHero with their own applications:

  • List events
  • Get the schedule for an event
  • Get the racers in a run
  • Update racer name and attributes

Racers

For building applications for racers or spectators to use:

  • Search by transponder to get a single racer's current position and times

TV/Broadcast

For livestream and TV applications, we offer several feeds designed to populate on-screen overlays, tickers and leaderboards:

  • RSS feed of most recently completed run to generate 
  • RSS feed of positions and times for live run
  • RSS feed of entry list for next run
  • CSV feed of positions and times for live run

Web Widgets

In addition, we also offer prebuilt HTML/JS embeds for results and live timing. Sign in to your RaceHero account and look under "Distribute Results" and "Live Timing".

Sign up for your own API key:

First, you'll need to create an Organizer account. If you have already signed up as an attendee, you'll need to use a different email address. Sign up as an organizer here: https://racehero.io/relay


Next, explore the organizer dashboard and within you'll find an API key link to the left. 

Note: Basic authentication will be required to access RaceHero API. Put the API key as username and any password (or blank). E.g.: curl -u {apikey}:x https://...  or curl -u {apikey}: https://...


Apiary Docs for reference: https://racehero.docs.apiary.io/#/authentication