get https://api.triathlon.org/v1/events//programs//results
The Program Results method returns all information with regards to the results of a program including all meta information associated. The results of this call may be used to display the results of a program directly such as on the World Triathlon Series site.
Results from this API call may be limited by either specifying a limit parameter which returns that number of results in the results object or by supplying a pipe delimited list of positions should only certain positions be required such as the podium athletes.
The following example shows the podium results of the 2014 World Triathlon Auckland (78726) Elite Women (264331) (the same result could be achieved with limit=3 parameter)
curl --header "apikey: [[app:key]]" https://api.triathlon.org/v1/events/78726/programs/264331/results?position=1|2|3
Split Headers
The headers of a race are dependent on the format of the race and the results method will return the correct split headers for each program in a headers array. For example in a standard distance triathlon the headers will be as follows:
{
"headers":[
{
"segment":"leg1",
"name":"Swim",
"distance":1500,
"units":"m",
"laps":2
},
{
"segment":"t1",
"name":"T1"
},
{
"segment":"leg2",
"name":"Bike",
"distance":40,
"units":"km",
"laps":8
},
{
"segment":"t2",
"name":"T2"
},
{
"segment":"leg3",
"name":"Run",
"distance":10,
"units":"km",
"laps":4
}
],
"headers_count":5
}
The headers match the values in the athlete's splits array. headers_count is a simple shortcut to identify how many headers are included in the result as this may vary according to the sport discipline and affect displaying of the results. Note that it is not possible to use the headers as a key in the splits array as in certain circumstances there are more than one discipline (key) of the same name.
Team Results
If the results of a program are team results shown by the team attribute which is a boolean the format of the results object differs as it contains basic team objects as opposed to athlete objects and contains additional information such as team split data.
{
"code":200,
"status":"success",
"data":{
"prog_id":271507,
"event_id":91030,
"prog_name":"4xMixed Relay",
"prog_date":"2015-07-19",
"prog_time":"16:51:00",
"results":[
{
"team_id":11428,
"team_title":"Team I France",
"team_slug":"team_i_france",
"team_country_id":166,
"team_profile_image":null,
"team_noc":"FRA",
"team_country_name":"France",
"team_country_isoa2":"FR",
"team_listing":"http://www.triathlon.org/athletes/profile/11428/team_i_france",
"team_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/fr.png",
"team_api_listing":"https://api.triathlon.org/v1/v1/athletes/11428",
"team_members":[
{
"athlete_id":56557,
"athlete_title":"Jeanne Lehair",
"athlete_slug":"jeanne_lehair",
"athlete_edit_date":null,
"athlete_first":"Jeanne",
"athlete_last":"Lehair",
"athlete_country_id":166,
"athlete_gender":"female",
"athlete_yob":"1996",
"validated":false,
"athlete_profile_image":null,
"athlete_noc":"FRA",
"athlete_country_name":"France",
"athlete_country_isoa2":"FR",
"athlete_listing":"http://www.triathlon.org/athletes/profile/56557/jeanne_lehair",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/fr.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/56557",
"athlete_categories":[
42
],
"splits":[
"00:04:10",
"00:00:39",
"00:10:29",
"00:00:23",
"00:05:22"
],
"result_id":492827,
"position":1,
"total_time":"00:21:01",
"team_order":1
},
{
"athlete_id":49390,
"athlete_title":"Dorian Coninx",
"athlete_slug":"dorian_coninx",
"athlete_edit_date":"2016-03-24T21:50:36+00:00",
"athlete_first":"Dorian",
"athlete_last":"Coninx",
"athlete_country_id":166,
"athlete_gender":"male",
"athlete_yob":"1994",
"validated":false,
"athlete_profile_image":"http://www.triathlon.org/images/athlete_thumbs/Dorian_Coninx_(FRA)_olympics_headshots_WA8_1295.jpg",
"athlete_noc":"FRA",
"athlete_country_name":"France",
"athlete_country_isoa2":"FR",
"athlete_listing":"http://www.triathlon.org/athletes/profile/49390/dorian_coninx",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/fr.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/49390",
"athlete_categories":[
42
],
"splits":[
"00:03:53",
"00:00:34",
"00:09:47",
"00:00:20",
"00:04:34"
],
"result_id":492828,
"position":1,
"total_time":"00:19:06",
"team_order":2
},
{
"athlete_id":56556,
"athlete_title":"Audrey Merle",
"athlete_slug":"audrey_merle",
"athlete_edit_date":"2015-10-16T19:00:20+00:00",
"athlete_first":"Audrey",
"athlete_last":"Merle",
"athlete_country_id":166,
"athlete_gender":"female",
"athlete_yob":"1995",
"validated":false,
"athlete_profile_image":null,
"athlete_noc":"FRA",
"athlete_country_name":"France",
"athlete_country_isoa2":"FR",
"athlete_listing":"http://www.triathlon.org/athletes/profile/56556/audrey_merle",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/fr.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/56556",
"athlete_categories":[
42
],
"splits":[
"00:04:20",
"00:00:41",
"00:10:31",
"00:00:22",
"00:05:17"
],
"result_id":492829,
"position":1,
"total_time":"00:21:10",
"team_order":3
},
{
"athlete_id":11143,
"athlete_title":"Vincent Luis",
"athlete_slug":"vincent_luis",
"athlete_edit_date":"2016-03-24T21:52:31+00:00",
"athlete_first":"Vincent",
"athlete_last":"Luis",
"athlete_country_id":166,
"athlete_gender":"male",
"athlete_yob":"1989",
"validated":false,
"athlete_profile_image":"http://www.triathlon.org/images/athlete_thumbs/Vincent_Luis_(FRA)_olympics_headshots_WA8_1310.jpg",
"athlete_noc":"FRA",
"athlete_country_name":"France",
"athlete_country_isoa2":"FR",
"athlete_listing":"http://www.triathlon.org/athletes/profile/11143/vincent_luis",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/fr.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/11143",
"athlete_categories":[
42
],
"splits":[
"00:03:50",
"00:00:30",
"00:10:04",
"00:00:21",
"00:04:35"
],
"result_id":492830,
"position":1,
"total_time":"00:19:18",
"team_order":4
}
],
"splits":[
"00:21:01",
"00:19:06",
"00:21:10",
"00:19:18"
],
"result_id":492806,
"position":1,
"total_time":"01:20:33",
"start_num":2
},
{
"team_id":13958,
"team_title":"Team I Australia",
"team_slug":"team_i_australia",
"team_country_id":111,
"team_profile_image":null,
"team_noc":"AUS",
"team_country_name":"Australia",
"team_country_isoa2":"AU",
"team_listing":"http://www.triathlon.org/athletes/profile/13958/team_i_australia",
"team_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/au.png",
"team_api_listing":"https://api.triathlon.org/v1/v1/athletes/13958",
"team_members":[
{
"athlete_id":39450,
"athlete_title":"Gillian Backhouse",
"athlete_slug":"gillian_backhouse",
"athlete_edit_date":"2016-02-03T21:18:40+00:00",
"athlete_first":"Gillian",
"athlete_last":"Backhouse",
"athlete_country_id":111,
"athlete_gender":"female",
"athlete_yob":"1991",
"validated":false,
"athlete_profile_image":"http://www.triathlon.org/images/athlete_thumbs/Gillian_Backhouse_(AUS)_olympics_headshots_WA8_1688.jpg",
"athlete_noc":"AUS",
"athlete_country_name":"Australia",
"athlete_country_isoa2":"AU",
"athlete_listing":"http://www.triathlon.org/athletes/profile/39450/gillian_backhouse",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/au.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/39450",
"athlete_categories":[
42
],
"splits":[
"00:04:00",
"00:00:38",
"00:10:30",
"00:00:22",
"00:05:20"
],
"result_id":492835,
"position":2,
"total_time":"00:20:48",
"team_order":1
},
{
"athlete_id":10141,
"athlete_title":"Aaron Royle",
"athlete_slug":"aaron_royle",
"athlete_edit_date":"2016-02-03T21:12:45+00:00",
"athlete_first":"Aaron",
"athlete_last":"Royle",
"athlete_country_id":111,
"athlete_gender":"male",
"athlete_yob":"1990",
"validated":false,
"athlete_profile_image":"http://www.triathlon.org/images/athlete_thumbs/Aaron_Royle_(AUS)_olympics_headshots_WA8_1698.jpg",
"athlete_noc":"AUS",
"athlete_country_name":"Australia",
"athlete_country_isoa2":"AU",
"athlete_listing":"http://www.triathlon.org/athletes/profile/10141/aaron_royle",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/au.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/10141",
"athlete_categories":[
42
],
"splits":[
"00:03:49",
"00:00:36",
"00:09:46",
"00:00:21",
"00:04:41"
],
"result_id":492836,
"position":2,
"total_time":"00:19:12",
"team_order":2
},
{
"athlete_id":15747,
"athlete_title":"Emma Jackson",
"athlete_slug":"emma_jackson",
"athlete_edit_date":"2016-02-03T21:16:35+00:00",
"athlete_first":"Emma",
"athlete_last":"Jackson",
"athlete_country_id":111,
"athlete_gender":"female",
"athlete_yob":"1991",
"validated":false,
"athlete_profile_image":"http://www.triathlon.org/images/athlete_thumbs/Emma_Jackson_(AUS)_olympics_headshots_WA8_1722.jpg",
"athlete_noc":"AUS",
"athlete_country_name":"Australia",
"athlete_country_isoa2":"AU",
"athlete_listing":"http://www.triathlon.org/athletes/profile/15747/emma_jackson",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/au.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/15747",
"athlete_categories":[
42
],
"splits":[
"00:04:24",
"00:00:39",
"00:10:36",
"00:00:23",
"00:05:11"
],
"result_id":492837,
"position":2,
"total_time":"00:21:12",
"team_order":3
},
{
"athlete_id":28500,
"athlete_title":"Ryan Bailie",
"athlete_slug":"ryan_bailie",
"athlete_edit_date":"2016-02-03T21:39:17+00:00",
"athlete_first":"Ryan",
"athlete_last":"Bailie",
"athlete_country_id":111,
"athlete_gender":"male",
"athlete_yob":"1990",
"validated":false,
"athlete_profile_image":"http://www.triathlon.org/images/athlete_thumbs/Ryan_Bailie_(AUS)_olympics_headshots_WA8_1680.jpg",
"athlete_noc":"AUS",
"athlete_country_name":"Australia",
"athlete_country_isoa2":"AU",
"athlete_listing":"http://www.triathlon.org/athletes/profile/28500/ryan_bailie",
"athlete_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/au.png",
"athlete_api_listing":"https://api.triathlon.org/v1/v1/athletes/28500",
"athlete_categories":[
42
],
"splits":[
"00:03:57",
"00:00:38",
"00:09:55",
"00:00:22",
"00:04:42"
],
"result_id":492838,
"position":2,
"total_time":"00:19:32",
"team_order":4
}
],
"splits":[
"00:20:48",
"00:19:12",
"00:21:12",
"00:19:32"
],
"result_id":492807,
"position":2,
"total_time":"01:20:42",
"start_num":4
}
],
"team":true,
"event":{
"event_id":91030,
"event_title":"2015 Hamburg ITU Triathlon Mixed Relay World Championships",
"event_slug":"2015_hamburg_itu_triathlon_mixed_relay_world_championships",
"event_edit_date":"2015-09-16T14:14:00+00:00",
"event_venue":"Hamburg",
"event_country":"Germany",
"event_latitude":53.55108,
"event_longitude":9.99368,
"event_date":"2015-07-18",
"event_finish_date":"2015-07-19",
"event_country_isoa2":"DE",
"event_country_noc":"GER",
"event_region_id":10,
"event_country_id":170,
"event_region_name":"Europe",
"event_categories":[
{
"cat_name":"World Championships",
"cat_id":348,
"cat_parent_id":0
}
],
"event_specifications":[
{
"cat_name":"Triathlon",
"cat_id":357,
"cat_parent_id":0
},
{
"cat_name":"4xMixed Relay",
"cat_id":380,
"cat_parent_id":357
}
],
"event_flag":"https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/de.png",
"event_listing":"http://www.triathlon.org/events/event/2015_hamburg_itu_triathlon_mixed_relay_world_championships",
"event_api_listing":"https://api.triathlon.org/v1/v1/events/91030"
},
"meta":null,
"headers":[
{
"segment":"team_leg1",
"name":"Leg 1"
},
{
"segment":"team_leg2",
"name":"Leg 2"
},
{
"segment":"team_leg3",
"name":"Leg 3"
},
{
"segment":"team_leg4",
"name":"Leg 4"
}
],
"headers_count":4,
"team_headers":[
{
"segment":"leg1",
"name":"Swim",
"distance":300,
"units":"m",
"laps":1
},
{
"segment":"t1",
"name":"T1"
},
{
"segment":"leg2",
"name":"Bike",
"distance":6.6,
"units":"km",
"laps":2
},
{
"segment":"t2",
"name":"T2"
},
{
"segment":"leg3",
"name":"Run",
"distance":1.6,
"units":"km",
"laps":2
}
],
"team_headers_count":5
}
}
Additionally a team_headers and team_headers_count attributes will be present where team_headers indicates the individual splits that comprise the leg of the team event.