{"_id":"563a4f1ddaf1c00d00136dc0","githubsync":"","parentDoc":null,"version":{"_id":"55773a5ba042551900b002ce","project":"55773a5ba042551900b002cb","__v":18,"createdAt":"2015-06-09T19:11:23.764Z","releaseDate":"2015-06-09T19:11:23.764Z","categories":["55773a5ca042551900b002cf","55773a6ce6063e0d00481380","55773ab007e7110d001043ec","55773abaa042551900b002d5","55773ac207e7110d001043ed","55773acb07e7110d001043ee","55773ad3a042551900b002d6","55773adce6063e0d00481383","55773ae4a042551900b002d7","55773af307e7110d001043ef","55773af907e7110d001043f0","55773b0407e7110d001043f1","563a4f7ad25e8919005f3f39","563a4fcaa19edf0d00972321","564a70dc4cd0521700523edf","564b797bcc472d0d00da9435","564b855b766d4923004e1fd1","59cd4b81935249001c77c48e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Motherboard","version_clean":"1.0.0","version":"1"},"category":{"_id":"55773ab007e7110d001043ec","project":"55773a5ba042551900b002cb","pages":["563a4f1ddaf1c00d00136dc0","563a4f351846790d0089535b","563a4f47f0c29b1700daafdf","563a4f54c63a22190018dca3","563a4f61daf1c00d00136dc2","563a4fb9d25e8919005f3f3a","56707e6681801f0d00802f7e","56a91a3e2036420d002d234f","56afb741e0b1e40d00c53751","56afc6eb1486990d009c0f1c","56c35c4ba869d017002ea550"],"version":"55773a5ba042551900b002ce","__v":11,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-06-09T19:12:48.377Z","from_sync":false,"order":0,"slug":"introduction","title":"Introduction"},"project":"55773a5ba042551900b002cb","user":"546d17e2eb9cfd1400dd4529","__v":65,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-04T18:31:57.980Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"The **Triathlon.org API Platform** allows access to the entire Triathlon.org infrastructure and data. The platform consists of several distinct APIs which cover a variety of use-cases. Whether you are a researcher, media or a fan you'll find comprehensive guides and documentation to help you start working with the Triathlon API platform as quickly as possible, as well as support if you get stuck.\n[block:callout]\n{\n \"type\": \"warning\",\n \"title\": \"This is a Beta Release\",\n \"body\": \"What do we mean by a *beta* release? Whilst we do not intend to make any significant changes the API *may* change suddenly and significantly, without warning. There are likely a few bugs hiding out as well, but we’ll work quickly to squash them. Please let us know of any specific issues using the support link above.\"\n}\n[/block]\n\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/w2WBMG2bTD6TahNs2MG3_150919-chicago-elite-m-web-msj-43.jpg\",\n \"150919-chicago-elite-m-web-msj-43.jpg\",\n \"1629\",\n \"1084\",\n \"#937062\",\n \"\"\n ],\n \"caption\": \"Results, athlete profiles, rankings, advanced statistics and all media content is available via API.\"\n }\n ]\n}\n[/block]\n* [Athletes API](https://developers.triathlon.org/docs/athletes-api-overview)\n* [Events API](https://developers.triathlon.org/docs/events-api-overview)\n* [Rankings API](https://triathlon-api.readme.io/docs/rankings-api-overview)\n* [Content API](https://developers.triathlon.org/docs/content-api-overview)\n* [Federation API](https://developers.triathlon.org/docs/federation-api-overview)\n* [Courses API](https://developers.triathlon.org/docs/courses-api-overview)\n* [Statistics API](https://triathlon-api.readme.io/docs/statistics-api-overview)\n* [Subscriptions API](https://developers.triathlon.org/docs/subscriptions-api-overview)\n* [Live API](https://developers.triathlon.org/docs/live-api-overview)\n* [Streaming API](https://developers.triathlon.org/docs/streaming-api-overview)\n* [Search API](https://developers.triathlon.org/docs/search-api-overview)\n* [Team API](https://developers.triathlon.org/docs/team-api-overview)\n* [TriathlonLive API](https://developers.triathlon.org/docs/triathlonlive-api-overview) \n[block:api-header]\n{\n \"type\": \"basic\",\n \"title\": \"Endpoints\"\n}\n[/block]\nAll API calls require authentication via an API key and all requests should be made to the `https://api.triathlon.org` endpoint. Please see the [Obtaining Access Keys](https://developers.triathlon.org/docs/triathlon-api-overview#obtaining-access-keys) and [Authentication](https://developers.triathlon.org/docs/authentication) sections for more information.\n\nThe API is [CORS ](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) enabled meaning that you are free to directly use the responses but care should be taken to conceal the API keys.\n[block:api-header]\n{\n \"type\": \"basic\",\n \"title\": \"Obtaining Access Keys\"\n}\n[/block]\nAll users will need to create an application in order to obtain an API key that are required for all requests. To register an application and to get a free API key please visit [https://apps.api.triathlon.org/register](https://apps.api.triathlon.org/register).\n[block:callout]\n{\n \"type\": \"success\",\n \"title\": \"Join us on Slack\",\n \"body\": \"Join us on the [triathlon-developers Slack channel](http://slack.developers.triathlon.org) to get real time support, guidance or to demonstrate your application.\"\n}\n[/block]\n\n[block:api-header]\n{\n \"type\": \"basic\",\n \"title\": \"Rate Limiting\"\n}\n[/block]\nThere are currently no rate limits on API requests however we operate a fair usage policy and reserve the right to limit/curtail access to any applications seen to abuse this policy.\n[block:api-header]\n{\n \"type\": \"basic\",\n \"title\": \"Using the API Explorer\"\n}\n[/block]\nYou may test the API using the interactive API explorer. You will need to provide your authentication information by clicking the key icon and entering your application key. Using this interface you may send valid requests to the API such as the following example:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/i6CBzqMiQYCOQAqwvenB_api-explorer.png\",\n \"api-explorer.png\",\n \"792\",\n \"602\",\n \"#61b47a\",\n \"\"\n ],\n \"caption\": \"Sample API Explorer Usage\"\n }\n ]\n}\n[/block]","excerpt":"","slug":"triathlon-api-overview","type":"basic","title":"Triathlon API Overview"}

TriathlonLive API

Triathlon API Overview

The **Triathlon.org API Platform** allows access to the entire Triathlon.org infrastructure and data. The platform consists of several distinct APIs which cover a variety of use-cases. Whether you are a researcher, media or a fan you'll find comprehensive guides and documentation to help you start working with the Triathlon API platform as quickly as possible, as well as support if you get stuck.
[block:callout]
{
"type": "warning",
"title": "This is a Beta Release",
"body": "What do we mean by a *beta* release? Whilst we do not intend to make any significant changes the API *may* change suddenly and significantly, without warning. There are likely a few bugs hiding out as well, but we’ll work quickly to squash them. Please let us know of any specific issues using the support link above."
}
[/block]
[block:image]
{
"images": [
{
"image": [
"https://files.readme.io/w2WBMG2bTD6TahNs2MG3_150919-chicago-elite-m-web-msj-43.jpg",
"150919-chicago-elite-m-web-msj-43.jpg",
"1629",
"1084",
"#937062",
""
],
"caption": "Results, athlete profiles, rankings, advanced statistics and all media content is available via API."
}
]
}
[/block]
* [Athletes API](https://developers.triathlon.org/docs/athletes-api-overview)
* [Events API](https://developers.triathlon.org/docs/events-api-overview)
* [Rankings API](https://triathlon-api.readme.io/docs/rankings-api-overview)
* [Content API](https://developers.triathlon.org/docs/content-api-overview)
* [Federation API](https://developers.triathlon.org/docs/federation-api-overview)
* [Courses API](https://developers.triathlon.org/docs/courses-api-overview)
* [Statistics API](https://triathlon-api.readme.io/docs/statistics-api-overview)
* [Subscriptions API](https://developers.triathlon.org/docs/subscriptions-api-overview)
* [Live API](https://developers.triathlon.org/docs/live-api-overview)
* [Streaming API](https://developers.triathlon.org/docs/streaming-api-overview)
* [Search API](https://developers.triathlon.org/docs/search-api-overview)
* [Team API](https://developers.triathlon.org/docs/team-api-overview)
* [TriathlonLive API](https://developers.triathlon.org/docs/triathlonlive-api-overview)
[block:api-header]
{
"type": "basic",
"title": "Endpoints"
}
[/block]
All API calls require authentication via an API key and all requests should be made to the `https://api.triathlon.org` endpoint. Please see the [Obtaining Access Keys](https://developers.triathlon.org/docs/triathlon-api-overview#obtaining-access-keys) and [Authentication](https://developers.triathlon.org/docs/authentication) sections for more information.
The API is [CORS ](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) enabled meaning that you are free to directly use the responses but care should be taken to conceal the API keys.
[block:api-header]
{
"type": "basic",
"title": "Obtaining Access Keys"
}
[/block]
All users will need to create an application in order to obtain an API key that are required for all requests. To register an application and to get a free API key please visit [https://apps.api.triathlon.org/register](https://apps.api.triathlon.org/register).
[block:callout]
{
"type": "success",
"title": "Join us on Slack",
"body": "Join us on the [triathlon-developers Slack channel](http://slack.developers.triathlon.org) to get real time support, guidance or to demonstrate your application."
}
[/block]
[block:api-header]
{
"type": "basic",
"title": "Rate Limiting"
}
[/block]
There are currently no rate limits on API requests however we operate a fair usage policy and reserve the right to limit/curtail access to any applications seen to abuse this policy.
[block:api-header]
{
"type": "basic",
"title": "Using the API Explorer"
}
[/block]
You may test the API using the interactive API explorer. You will need to provide your authentication information by clicking the key icon and entering your application key. Using this interface you may send valid requests to the API such as the following example:
[block:image]
{
"images": [
{
"image": [
"https://files.readme.io/i6CBzqMiQYCOQAqwvenB_api-explorer.png",
"api-explorer.png",
"792",
"602",
"#61b47a",
""
],
"caption": "Sample API Explorer Usage"
}
]
}
[/block]