Welcome to the Triathlon API
Developer Hub

Whether you are a researcher, media, or a fan, you'll find comprehensive guides and documentation to help you get up and running with the Triathlon API.

Get Started

Paralympic Head-to-Head Matchups

To complement our Olympic head-to-head matchups tool we have developed a similar version for the Paralympic Games in Rio.

Paralympic head-to-head tool

Paralympic head-to-head tool

Once again, all data comes from the Triathlon API and a similar logic may be used (as detailed in this article) to extract the data. Additional information in terms of detailed biographies, which are included as part of the Retrieve Athlete Information API call have been included as well as a full World Championship results history.

When accessing the World Championship results for an athlete care must be taken to exclude programs that are not Paratriathlon World Championships (for example an "Open" race). For example the API call for Elizabeth Baker would be:

curl --header "apikey: YOUR_APP_KEY" "https://api.triathlon.org/v1/athletes/96424/results?category_id=348"

A curtailed response from this API call is shown below which, whilst it indicates there is one World Championship result, on closer inspection of the prog_name is actually an "Open" race at the event and not the Paratriathlon World Championship proper and so should be excluded.

{
    "code": 200,
    "status": "success",
    "total": 1,
    "per_page": 10,
    "current_page": 1,
    "last_page": 1,
    "next_page_url": null,
    "prev_page_url": null,
    "from": 1,
    "to": 1,
    "data": [
        {
            "event_id": 90168,
            "event_title": "2015 ITU World Triathlon Grand Final Chicago",
            "event_slug": "2015_itu_world_triathlon_grand_final_chicago",
            "event_edit_date": "2016-07-06T07:57:38+00:00",
            "event_venue": "Chicago",
            "event_country": "United States",
            "event_latitude": 41.87811,
            "event_longitude": -87.6298,
            "event_date": "2015-09-15",
            "event_finish_date": "2015-09-20",
            "event_country_isoa2": "US",
            "event_country_noc": "USA",
            "event_region_id": 11,
            "event_country_id": 293,
            "event_region_name": "Americas",
            "event_categories": [
                {
                    "cat_name": "World Championships",
                    "cat_id": 348,
                    "cat_parent_id": null
                }
            ],
            "event_flag": "https://f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com/images/icons/us.png",
            "event_listing": "http://www.triathlon.org/events/event/2015_itu_world_triathlon_grand_final_chicago",
            "event_api_listing": "https://api.triathlon.org/v1/v1/events/90168",
            "prog_id": 278801,
            "prog_name": "Women's PT5 OPEN",
            "result_id": 503667,
            "position": 1,
            "total_time": "01:17:41",
            "result_listing": "http://www.triathlon.org/results/result/2015_itu_world_triathlon_grand_final_chicago/278801"
        }
    ]
}

Due to varying changes in Paratriathlon classification over the years, with the latest Paratriathlon classification system only coming into existence in 2014, some of the returned data can be more difficult to work with and makes historical comparisons much more difficult. If you have used the API to extract Paratriathlon information we'd be interested in hearing from you on our Slack channel.