This is an old revision of the document!


API

General

When on the same local network as the master timing computer, the built-in web server can be used to access results data live from the software.

This can for instance be useful for TV production, custom big screen displays etc.

The basic endpoint is the same as the regular web interface/commentator display (for example http://localhost). All requests are made using GET requests to the specific endpoints, with any parameters added as query string parameters. The response will be given in JSON format.

Endpoints

All endpoints should be prefixed with /api/1.1. Example: http://localhost/api/1.1/event/races

Endpoint Parameters Description
/event/races None List all races
/timing/locations None List all timing locations
/timing/points None List all timing points
/timing/raceclock race_id (required) Get the current race clock and gun start time of a given race
/results/toplist race_id (required),
page, page_size
List all finishers of the given race, in position order
/results/toplistforpoint race_id (required),
point_id (required),
gender (optional),
page, page_size
List all participants, in position order for a specific timing point
/results/latest point_id,
location_id,
page, page_size
List the most recent passes of either a specific timing point or timing location (one of the is required )
/results/list race_id,
racenum,
search,
page, page_size
List all results in the event, regardless of finish status. Optional filtering on race, race number or text search
/results/leaders race_id (required),
gender (optional),
page_size
Show the leaderboard of a specific race, optionally filtered by gender
/results/participant race_id (optional),
result_id (optional)
racenum (optional)
Get the result of a single participant, including split times. At least one of result_id or racenum should be specified. race_id can be used to distinguish if multiple participants have the same race number.

Default values if not set: page =1, page_size = 50.