As you might have noticed, triathlon.org has a brand new website!

As part of the redevelopment process, we have moved to a new CMS, which means you will see possibly see minor breaking changes on the API. We have tried to minimize changes as much as possible. In most cases, you will not need to do anything.

📘

Note: Currently data on the API will be outdated until we move to the new data source. Please contact us webmaster[at]triathlon.org if you need urgent access to new data.

❗️

Deadline to apply the changes: 31 January 2025

Overall changes

• Slug format has changed. It will now be with dashes (-) instead of underscores(_).
• Links to webpages and assets such as flags and profile pictures have been updated. Please make sure where possible to always use the available URLs provided by the API without modification.

Federation listing

• federation_affiliation_status will be lowercase, separated by underscores
• federation_street replaced by address_line_1 and address_line_2, zipcode replaced with postal_code

Athlete details endpoint

https://developers.triathlon.org/reference/retrieve-athlete-information

• sponsors will always return null as this has been removed
• The following keys have been removed for privacy reasons and will no longer be included in JSON responses:
  • place_of_birth
  • weight
  • height
  • nickname
  • residence and sub-keys city and country
  • languages_spoken
  • debut
  • occupation
  • other_sports_competed
  • higher_education
  • marital_status
  • hobbies
  • spouse_children
  • hero
  • memorable_achievement
  • injuries
  • coach
  • tag_info

Courses details endpoint

https://developers.triathlon.org/reference/retrieve-course-information

• latest_news will always return null, we have removed this
• contact will return an array of objects instead of a plain object with the following keys:
  • name
  • email
  • phone
  • fax

Team listing endpoint

https://developers.triathlon.org/reference/team-listings

• tag_info has been removed

Athlete ranking breakdown endpoint

Athlete ranking breakdown: https://developers.triathlon.org/reference/athlete-ranking-breakdown

• event_container has been removed

Retrieve team information endpoint

https://developers.triathlon.org/reference/retrieve-team-information

• We no longer support tagging teams in content: latest_images, latest_news and latest_videos will return null

Retrieve event information endpoint

https://developers.triathlon.org/reference/retrieve-event-information

• technical_delegate will be returned as an array of objects instead of an object
• hr_gallery will be deprecated, for now it will always return false. We no longer will differentiate between web-res and high-res galleries.

Retrieve video information endpoint

https://developers.triathlon.org/reference/retrieve-video-information

• tags key will be removed

Deprecated endpoints

Will continue to work but will not return up-to-date information:

• https://developers.triathlon.org/reference/team-videos
• https://developers.triathlon.org/reference/team-news
• https://developers.triathlon.org/reference/team-images