Events API Overview

The Events API allows access to all event resources which includes event listings, entries and result information.

Run in PostmanRun in Postman

15001500

The Events API provides all event related data

The Events API is comprised of the following underlying resources:

  • Events - data related to the event itself including specific event information, related media and medal tallies.
  • Programs - data related to programs (or races) at an event such as course information and atmospheric conditions (which vary between programs at the same event)
  • Entries - data relating to the entries of a specific program (start lists and wait lists)
  • Results - data relating to the results of a specific program

In a nutshell, entry and result data belong to a program and each program belongs to an event. There can be many entries and results per program and many programs per event. For more information with working with the Events API please consult the Getting Started with the Events API guide.

Each of the resources has it's own defined type as listed below.

Basic Event Object

When using the event listing call or where events are returned from different API calls a basic event object is returned which will always conform to the following specification. If further detail is required request the full event listing using the Retrieve Event Information API method.

{
   "event_id":5105,
   "event_title":"2009 Dextro Energy Triathlon - ITU World Championship Grand Final Gold Coast",
   "event_slug":"2009_dextro_energy_triathlon_-_itu_world_championship_grand_final_gold_coas",
   "event_edit_date":"2013-01-29T02:26:42+00:00",
   "event_venue":"Gold Coast",
   "event_country":"Australia",
   "event_latitude":-28.136289,
   "event_longitude":153.477806,
   "event_date":"2009-09-09",
   "event_finish_date":"2009-09-13",
   "event_country_isoa2":"AU",
   "event_country_noc":"AUS",
   "event_region_id":14,
   "event_country_id":111,
   "event_region_name":"Oceania",
   "event_categories":[
      {
         "cat_name":"World Championships",
         "cat_id":348,
         "cat_parent_id":0
      },
      {
         "cat_name":"World Triathlon Series",
         "cat_id":351,
         "cat_parent_id":0
      }
   ],
   "event_specifications":[
      {
         "cat_name":"Triathlon",
         "cat_id":357,
         "cat_parent_id":0
      },
      {
         "cat_name":"Sprint",
         "cat_id":376,
         "cat_parent_id":357
      },
      {
         "cat_name":"Standard",
         "cat_id":377,
         "cat_parent_id":357
      },
      {
         "cat_name":"Paratriathlon",
         "cat_id":381,
         "cat_parent_id":357
      }
   ],
   "event_flag":"https:\/\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\/images\/icons\/au.png",
   "event_listing":"http:\/\/www.triathlon.org\/events\/event\/2009_dextro_energy_triathlon_-_itu_world_championship_grand_final_gold_coas",
   "event_api_listing":"https:\/\/api.triathlon.org\/v1\/v1\/events\/5105"
}

Program Object

A program object comprises the basic data required for all programs. For more program data the Retrieve Program Information API method should be used.

{  
   "prog_id":269745,
   "event_id":91461,
   "prog_name":"Elite Coaches",
   "prog_date":"2015-03-21",
   "prog_time":"12:34:00",
   "results":false,
   "team":false
}

Entry Object

An entry object comprises an individual program entry and is made up of an athlete object together with the individual entry status and data. Typically these objects are presented in an array via the Program Entries method that is used for generating start and wait lists and contains other meta information regarding the event and program.

{
   "athlete_id":21486,
   "athlete_title":"Pamella Oliveira",
   "athlete_slug":"pamella_oliveira",
   "athlete_first":"Pamella",
   "athlete_last":"Oliveira",
   "athlete_country_id":127,
   "athlete_gender":"female",
   "athlete_yob":"1987",
   "validated":false,
   "athlete_profile_image":null,
   "athlete_noc":"BRA",
   "athlete_country_name":"Brazil",
   "athlete_country_isoa2":"BR",
   "athlete_listing":"http:\/\/www.triathlon.org\/athletes\/profile\/21486\/pamella_oliveira",
   "athlete_flag":"https:\/\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\/images\/icons\/br.png",
   "athlete_api_listing":"https:\/\/api.triathlon.org\/v1\/v1\/athletes\/21486",
   "athlete_categories":[
      42
   ],
   "entry_id":353216,
   "program_id":270564,
   "approved":true,
   "start_num":33
}

Result Object

A result object comprises an individual result and is made up of an athlete object together with the individual result and splits data. Typically these objects are presented in an array via the Program Results method that is used for generating result listings and contains other meta information regarding the event and program including split information.

{
   "athlete_id":40887,
   "athlete_title":"Gwen Jorgensen",
   "athlete_slug":"gwen_jorgensen",
   "athlete_first":"Gwen",
   "athlete_last":"Jorgensen",
   "athlete_country_id":293,
   "athlete_gender":"female",
   "athlete_yob":"1986",
   "validated":false,
   "athlete_profile_image":"http:\/\/www.triathlon.org\/images\/athlete_thumbs\/Gwen_Jorgensen2.jpg",
   "athlete_noc":"USA",
   "athlete_country_name":"United States",
   "athlete_country_isoa2":"US",
   "athlete_listing":"http:\/\/www.triathlon.org\/athletes\/profile\/40887\/gwen_jorgensen",
   "athlete_flag":"https:\/\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\/images\/icons\/us.png",
   "athlete_api_listing":"https:\/\/api.triathlon.org\/v1\/v1\/athletes\/40887",
   "athlete_categories":[
      42
   ],
   "splits":[
      "00:19:25",
      "00:00:28",
      "01:03:06",
      "00:00:26",
      "00:33:35"
   ],
   "result_id":476317,
   "position":1,
   "total_time":"01:56:59",
   "start_num":2
}