Result Format

Documentation

The **Program Entries** method returns an array of entry objects for a program and may be filtered to return either a **start list **(default) or **wait list**. Entries are contained within the entries array and are composed of a basic entry objects which include a basic athlete object plus additional information such as `start_num`.
The `approved` boolean indicates whether this entry has been confirmed and the athlete is on the start list or still on the wait list. Clearly all entries with type `start` will be approved and all entries with type `wait` will not be approved.
In addition the method will return a full program object and basic event object such that complete start list pages may be derived from a single API call such as those used on the [World Triathlon Series site](http://wts.triathlon.org/start_lists/2015_itu_world_triathlon_stockholm/271862).
[block:callout]
{
"type": "info",
"title": "Wait list Availability",
"body": "Wait lists are only publicly available 30 days before the start of the event. Before that time if the wait parameter type is specified a 401 unauthorized response will be returned."
}
[/block]
The following example shows the start list of the 2014 World Triathlon Auckland (78726) Elite Women (264331). As the default type is `start` there is no need to specify this.
[block:code]
{
"codes": [
{
"code": "curl --header \"apikey: [[app:key]]\" https://api.triathlon.org/v1/events/78726/programs/264331/entries",
"language": "curl"
}
]
}
[/block]
To retrieve the waitlist for the same event (assuming we are greater than 30 days before the event) the following API call could be used:
[block:code]
{
"codes": [
{
"code": "curl --header \"apikey: [[app:key]]\" https://api.triathlon.org/v1/events/78726/programs/264331/entries?type=wait",
"language": "curl"
}
]
}
[/block]
[block:api-header]
{
"type": "basic",
"title": "Team Entries"
}
[/block]
When the specified prog_id corresponds to a team program each entry will contain a basic team object which when applicable includes a `team_members` array of athlete objects. Therefore it is possible to view the overall team start lists together with a breakdown of all individual athletes comprising that team. Where no team members have been entered for the team the `team_members` object will be null.
[block:code]
{
"codes": [
{
"code": "{\n \"code\":200,\n \"status\":\"success\",\n \"data\":{\n \"prog_id\":271507,\n \"event_id\":91030,\n \"prog_name\":\"4xMixed Relay\",\n \"prog_date\":\"2015-07-19\",\n \"prog_time\":\"16:51:00\",\n \"results\":true,\n \"team\":true,\n \"event\":{\n \"event_id\":91030,\n \"event_title\":\"2015 Hamburg ITU Triathlon Mixed Relay World Championships\",\n \"event_slug\":\"2015_hamburg_itu_triathlon_mixed_relay_world_championships\",\n \"event_edit_date\":\"2015-09-16T14:14:00+00:00\",\n \"event_venue\":\"Hamburg\",\n \"event_country\":\"Germany\",\n \"event_latitude\":53.55108,\n \"event_longitude\":9.99368,\n \"event_date\":\"2015-07-18\",\n \"event_finish_date\":\"2015-07-19\",\n \"event_country_isoa2\":\"DE\",\n \"event_country_noc\":\"GER\",\n \"event_region_id\":10,\n \"event_country_id\":170,\n \"event_region_name\":\"Europe\",\n \"event_categories\":[\n {\n \"cat_name\":\"World Championships\",\n \"cat_id\":348,\n \"cat_parent_id\":0\n }\n ],\n \"event_specifications\":[\n {\n \"cat_name\":\"Triathlon\",\n \"cat_id\":357,\n \"cat_parent_id\":0\n },\n {\n \"cat_name\":\"4xMixed Relay\",\n \"cat_id\":380,\n \"cat_parent_id\":357\n }\n ],\n \"event_flag\":\"https:\\/\\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\\/images\\/icons\\/de.png\",\n \"event_listing\":\"http:\\/\\/www.triathlon.org\\/events\\/event\\/2015_hamburg_itu_triathlon_mixed_relay_world_championships\",\n \"event_api_listing\":\"https:\\/\\/api.triathlon.org\\/v1\\/v1\\/events\\/91030\"\n },\n \"meta\":null,\n \"entries\":[\n {\n \"team_id\":11448,\n \"team_title\":\"Team I Great Britain\",\n \"team_slug\":\"team_i_great_britain\",\n \"team_country_id\":292,\n \"team_profile_image\":null,\n \"team_noc\":\"GBR\",\n \"team_country_name\":\"Great Britain\",\n \"team_country_isoa2\":\"GB\",\n \"team_listing\":\"http:\\/\\/www.triathlon.org\\/athletes\\/profile\\/11448\\/team_i_great_britain\",\n \"team_flag\":\"https:\\/\\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\\/images\\/icons\\/gb.png\",\n \"team_api_listing\":\"https:\\/\\/api.triathlon.org\\/v1\\/v1\\/athletes\\/11448\",\n \"team_members\":[\n {\n \"athlete_id\":7795,\n \"athlete_title\":\"Vicky Holland\",\n \"athlete_slug\":\"vicky_holland\",\n \"athlete_first\":\"Vicky\",\n \"athlete_last\":\"Holland\",\n \"athlete_country_id\":292,\n \"athlete_gender\":\"female\",\n \"athlete_yob\":\"1986\",\n \"validated\":false,\n \"athlete_profile_image\":\"http:\\/\\/www.triathlon.org\\/images\\/athlete_thumbs\\/holland_vicky.jpg\",\n \"athlete_noc\":\"GBR\",\n \"athlete_country_name\":\"Great Britain\",\n \"athlete_country_isoa2\":\"GB\",\n \"athlete_listing\":\"http:\\/\\/www.triathlon.org\\/athletes\\/profile\\/7795\\/vicky_holland\",\n \"athlete_flag\":\"https:\\/\\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\\/images\\/icons\\/gb.png\",\n \"athlete_api_listing\":\"https:\\/\\/api.triathlon.org\\/v1\\/v1\\/athletes\\/7795\",\n \"athlete_categories\":[\n 42\n ]\n }\n ],\n \"entry_id\":369743,\n \"program_id\":271507,\n \"approved\":true,\n \"start_num\":1\n }\n ]\n }\n}",
"language": "json"
}
]
}
[/block]
[block:callout]
{
"type": "warning",
"title": "Team members and orders do not have to be specified until 60 mins before the race start",
"body": "Due to the rules accompanying team entries finalised start lists including all team members are only available 60 mins before the race start."
}
[/block]