{"_id":"563a51bddaf1c00d00136dc8","user":"546d17e2eb9cfd1400dd4529","project":"55773a5ba042551900b002cb","category":{"_id":"55773ad3a042551900b002d6","pages":["563a51bddaf1c00d00136dc8","563a583ac8baa517009d07e7","563a5861a19edf0d00972340","563a5870c8baa517009d07ea","563a589a4cc3621900ac2770","563a58b3c8baa517009d07ed","563a58c7e1313f0d00c8679a","563a58ea4cc3621900ac2779","564a00823242592b00338a26"],"project":"55773a5ba042551900b002cb","__v":9,"version":"55773a5ba042551900b002ce","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-06-09T19:13:23.707Z","from_sync":false,"order":4,"slug":"rankings-api","title":"Rankings API"},"parentDoc":null,"__v":31,"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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-04T18:43:09.388Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"The Rankings API allows programmatic access to the latest ranking data to enable rankings presentations and enhanced analysis.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/nEDUY5FPQLOYfBhTSZdb_rankings.jpg\",\n        \"rankings.jpg\",\n        \"1140\",\n        \"430\",\n        \"#2a9fee\",\n        \"\"\n      ],\n      \"caption\": \"All Ranking information is available via the Rankings API\",\n      \"sizing\": \"full\",\n      \"border\": true\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Available Rankings\"\n}\n[/block]\nThe table below displays a quick breakdown of all available rankings and their associated ids required for access (note: this is essentially the information provided in the [/rankings API call](https://triathlon-api.readme.io/docs/rankings-listing)).\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"You may use the Subscription API to be notified when Rankings are run and published\",\n  \"body\": \"\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Ranking ID\",\n    \"h-1\": \"Category\",\n    \"h-2\": \"Region\",\n    \"h-3\": \"Program\",\n    \"0-0\": \"[1](http://public.api.triathlon.org/v1/rankings/1)\",\n    \"1-0\": \"[2](http://public.api.triathlon.org/v1/rankings/2)\",\n    \"2-0\": \"[3](http://public.api.triathlon.org/v1/rankings/3)\",\n    \"3-0\": \"[4](http://public.api.triathlon.org/v1/rankings/4)\",\n    \"4-0\": \"[5](http://public.api.triathlon.org/v1/rankings/5)\",\n    \"5-0\": \"[6](http://public.api.triathlon.org/v1/rankings/6)\",\n    \"6-0\": \"[7](http://public.api.triathlon.org/v1/rankings/7)\",\n    \"7-0\": \"[8](http://public.api.triathlon.org/v1/rankings/8)\",\n    \"8-0\": \"[9](http://public.api.triathlon.org/v1/rankings/9)\",\n    \"9-0\": \"[10](http://public.api.triathlon.org/v1/rankings/10)\",\n    \"10-0\": \"[11](http://public.api.triathlon.org/v1/rankings/11)\",\n    \"11-0\": \"[12](http://public.api.triathlon.org/v1/rankings/12)\",\n    \"12-0\": \"[13](http://public.api.triathlon.org/v1/rankings/13)\",\n    \"13-0\": \"[14](http://public.api.triathlon.org/v1/rankings/14)\",\n    \"14-0\": \"[15](http://public.api.triathlon.org/v1/rankings/15)\",\n    \"0-1\": \"Paratriathlon\",\n    \"0-2\": \"-\",\n    \"1-1\": \"Paratriathlon\",\n    \"2-1\": \"Paratriathlon\",\n    \"3-1\": \"Paratriathlon\",\n    \"4-1\": \"Paratriathlon\",\n    \"5-1\": \"Paratriathlon\",\n    \"6-1\": \"Paratriathlon\",\n    \"7-1\": \"Paratriathlon\",\n    \"8-1\": \"Paratriathlon\",\n    \"9-1\": \"Paratriathlon\",\n    \"0-3\": \"Male PT1\",\n    \"1-3\": \"Male PT2\",\n    \"2-3\": \"Male PT3\",\n    \"3-3\": \"Male PT4\",\n    \"4-3\": \"Male PT5\",\n    \"5-3\": \"Female PT1\",\n    \"6-3\": \"Female PT2\",\n    \"7-3\": \"Female PT3\",\n    \"8-3\": \"Female PT4\",\n    \"9-3\": \"Female PT5\",\n    \"1-2\": \"-\",\n    \"2-2\": \"-\",\n    \"3-2\": \"-\",\n    \"4-2\": \"-\",\n    \"5-2\": \"-\",\n    \"6-2\": \"-\",\n    \"7-2\": \"-\",\n    \"8-2\": \"-\",\n    \"9-2\": \"-\",\n    \"10-1\": \"Olympic\",\n    \"11-1\": \"Olympic\",\n    \"12-1\": \"Points List\",\n    \"13-1\": \"Points List\",\n    \"14-1\": \"World Triathlon Series\",\n    \"15-1\": \"World Triathlon Series\",\n    \"15-0\": \"[16](http://public.api.triathlon.org/v1/rankings/16)\",\n    \"16-0\": \"[17](http://public.api.triathlon.org/v1/rankings/17)\",\n    \"17-0\": \"[18](http://public.api.triathlon.org/v1/rankings/18)\",\n    \"16-1\": \"Duathlon\",\n    \"17-1\": \"Duathlon\",\n    \"18-0\": \"[19](http://public.api.triathlon.org/v1/rankings/19)\",\n    \"18-1\": \"Long Distance Triathlon\",\n    \"19-0\": \"[20](http://public.api.triathlon.org/v1/rankings/20)\",\n    \"19-1\": \"Long Distance Triathlon\",\n    \"20-0\": \"[21](http://public.api.triathlon.org/v1/rankings/21)\",\n    \"20-1\": \"Junior Continental\",\n    \"21-0\": \"[22](http://public.api.triathlon.org/v1/rankings/22)\",\n    \"21-1\": \"Junior Continental\",\n    \"22-0\": \"[23](http://public.api.triathlon.org/v1/rankings/23)\",\n    \"20-2\": \"Americas\",\n    \"20-3\": \"Junior Men\",\n    \"21-2\": \"Americas\",\n    \"21-3\": \"Junior Women\",\n    \"22-1\": \"Junior Continental\",\n    \"23-1\": \"Junior Continental\",\n    \"22-2\": \"Europe\",\n    \"23-2\": \"Europe\",\n    \"22-3\": \"Junior Men\",\n    \"23-3\": \"Junior Women\",\n    \"23-0\": \"[24](http://public.api.triathlon.org/v1/rankings/24)\",\n    \"24-0\": \"[25](http://public.api.triathlon.org/v1/rankings/25)\",\n    \"24-1\": \"Winter Triathlon\",\n    \"25-0\": \"[26](http://public.api.triathlon.org/v1/rankings/26)\",\n    \"25-1\": \"Winter Triathlon\",\n    \"26-1\": \"Continental Rankings\",\n    \"26-0\": \"[27](http://public.api.triathlon.org/v1/rankings/27)\",\n    \"27-0\": \"[28](http://public.api.triathlon.org/v1/rankings/28)\",\n    \"27-1\": \"Continental Rankings\",\n    \"26-2\": \"Europe\",\n    \"26-3\": \"Elite Men\",\n    \"27-2\": \"Europe\",\n    \"27-3\": \"Elite Women\",\n    \"28-0\": \"[29](http://public.api.triathlon.org/v1/rankings/29)\",\n    \"29-0\": \"[30](http://public.api.triathlon.org/v1/rankings/30)\",\n    \"30-0\": \"[31](http://public.api.triathlon.org/v1/rankings/31)\",\n    \"31-0\": \"[32](http://public.api.triathlon.org/v1/rankings/32)\",\n    \"32-0\": \"[33](http://public.api.triathlon.org/v1/rankings/33)\",\n    \"33-0\": \"[34](http://public.api.triathlon.org/v1/rankings/34)\",\n    \"28-1\": \"Paralympic Qualification\",\n    \"29-1\": \"Paralympic Qualification\",\n    \"30-1\": \"Paralympic Qualification\",\n    \"31-1\": \"Paralympic Qualification\",\n    \"32-1\": \"Paralympic Qualification\",\n    \"33-1\": \"Paralympic Qualification\",\n    \"28-3\": \"Female PT2\",\n    \"29-3\": \"Female PT4\",\n    \"30-3\": \"Female PT5\",\n    \"31-3\": \"Male PT1\",\n    \"32-3\": \"Male PT2\",\n    \"33-3\": \"Male PT4\",\n    \"34-0\": \"[35](http://public.api.triathlon.org/v1/rankings/35)\",\n    \"35-0\": \"[36](http://public.api.triathlon.org/v1/rankings/36)\",\n    \"36-0\": \"[37](http://public.api.triathlon.org/v1/rankings/37)\",\n    \"37-0\": \"[38](http://public.api.triathlon.org/v1/rankings/38)\",\n    \"38-0\": \"[39](http://public.api.triathlon.org/v1/rankings/39)\",\n    \"39-0\": \"[40](http://public.api.triathlon.org/v1/rankings/40)\",\n    \"40-0\": \"[41](http://public.api.triathlon.org/v1/rankings/41)\",\n    \"41-0\": \"[42](http://public.api.triathlon.org/v1/rankings/42)\",\n    \"42-0\": \"[43](http://public.api.triathlon.org/v1/rankings/43)\",\n    \"43-0\": \"[44](http://public.api.triathlon.org/v1/rankings/44)\",\n    \"34-1\": \"Continental Points List\",\n    \"34-2\": \"Europe\",\n    \"35-2\": \"Europe\",\n    \"36-2\": \"Americas\",\n    \"37-2\": \"Americas\",\n    \"38-2\": \"Africa\",\n    \"39-2\": \"Africa\",\n    \"40-2\": \"Asia\",\n    \"41-2\": \"Asia\",\n    \"42-2\": \"Oceania\",\n    \"43-2\": \"Oceania\",\n    \"35-1\": \"Continental Points List\",\n    \"36-1\": \"Continental Points List\",\n    \"37-1\": \"Continental Points List\",\n    \"38-1\": \"Continental Points List\",\n    \"39-1\": \"Continental Points List\",\n    \"40-1\": \"Continental Points List\",\n    \"41-1\": \"Continental Points List\",\n    \"42-1\": \"Continental Points List\",\n    \"43-1\": \"Continental Points List\",\n    \"10-2\": \"-\",\n    \"11-2\": \"-\",\n    \"12-2\": \"-\",\n    \"13-2\": \"-\",\n    \"14-2\": \"-\",\n    \"15-2\": \"-\",\n    \"16-2\": \"-\",\n    \"17-2\": \"-\",\n    \"18-2\": \"-\",\n    \"19-2\": \"-\",\n    \"24-2\": \"-\",\n    \"25-2\": \"-\",\n    \"28-2\": \"-\",\n    \"29-2\": \"-\",\n    \"30-2\": \"-\",\n    \"31-2\": \"-\",\n    \"32-2\": \"-\",\n    \"33-2\": \"-\",\n    \"10-3\": \"Elite Men\",\n    \"12-3\": \"Elite Men\",\n    \"14-3\": \"Elite Men\",\n    \"16-3\": \"Elite Men\",\n    \"18-3\": \"Elite Men\",\n    \"24-3\": \"Elite Men\",\n    \"34-3\": \"Elite Men\",\n    \"36-3\": \"Elite Men\",\n    \"38-3\": \"Elite Men\",\n    \"40-3\": \"Elite Men\",\n    \"42-3\": \"Elite Men\",\n    \"11-3\": \"Elite Women\",\n    \"13-3\": \"Elite Women\",\n    \"15-3\": \"Elite Women\",\n    \"17-3\": \"Elite Women\",\n    \"19-3\": \"Elite Women\",\n    \"25-3\": \"Elite Women\",\n    \"35-3\": \"Elite Women\",\n    \"37-3\": \"Elite Women\",\n    \"39-3\": \"Elite Women\",\n    \"41-3\": \"Elite Women\",\n    \"43-3\": \"Elite Women\"\n  },\n  \"cols\": 4,\n  \"rows\": 44\n}\n[/block]","excerpt":"","slug":"rankings-api-overview","type":"basic","title":"Rankings API Overview"}

Rankings API Overview


The Rankings API allows programmatic access to the latest ranking data to enable rankings presentations and enhanced analysis. [block:image] { "images": [ { "image": [ "https://files.readme.io/nEDUY5FPQLOYfBhTSZdb_rankings.jpg", "rankings.jpg", "1140", "430", "#2a9fee", "" ], "caption": "All Ranking information is available via the Rankings API", "sizing": "full", "border": true } ] } [/block] [block:api-header] { "type": "basic", "title": "Available Rankings" } [/block] The table below displays a quick breakdown of all available rankings and their associated ids required for access (note: this is essentially the information provided in the [/rankings API call](https://triathlon-api.readme.io/docs/rankings-listing)). [block:callout] { "type": "success", "title": "You may use the Subscription API to be notified when Rankings are run and published", "body": "" } [/block] [block:parameters] { "data": { "h-0": "Ranking ID", "h-1": "Category", "h-2": "Region", "h-3": "Program", "0-0": "[1](http://public.api.triathlon.org/v1/rankings/1)", "1-0": "[2](http://public.api.triathlon.org/v1/rankings/2)", "2-0": "[3](http://public.api.triathlon.org/v1/rankings/3)", "3-0": "[4](http://public.api.triathlon.org/v1/rankings/4)", "4-0": "[5](http://public.api.triathlon.org/v1/rankings/5)", "5-0": "[6](http://public.api.triathlon.org/v1/rankings/6)", "6-0": "[7](http://public.api.triathlon.org/v1/rankings/7)", "7-0": "[8](http://public.api.triathlon.org/v1/rankings/8)", "8-0": "[9](http://public.api.triathlon.org/v1/rankings/9)", "9-0": "[10](http://public.api.triathlon.org/v1/rankings/10)", "10-0": "[11](http://public.api.triathlon.org/v1/rankings/11)", "11-0": "[12](http://public.api.triathlon.org/v1/rankings/12)", "12-0": "[13](http://public.api.triathlon.org/v1/rankings/13)", "13-0": "[14](http://public.api.triathlon.org/v1/rankings/14)", "14-0": "[15](http://public.api.triathlon.org/v1/rankings/15)", "0-1": "Paratriathlon", "0-2": "-", "1-1": "Paratriathlon", "2-1": "Paratriathlon", "3-1": "Paratriathlon", "4-1": "Paratriathlon", "5-1": "Paratriathlon", "6-1": "Paratriathlon", "7-1": "Paratriathlon", "8-1": "Paratriathlon", "9-1": "Paratriathlon", "0-3": "Male PT1", "1-3": "Male PT2", "2-3": "Male PT3", "3-3": "Male PT4", "4-3": "Male PT5", "5-3": "Female PT1", "6-3": "Female PT2", "7-3": "Female PT3", "8-3": "Female PT4", "9-3": "Female PT5", "1-2": "-", "2-2": "-", "3-2": "-", "4-2": "-", "5-2": "-", "6-2": "-", "7-2": "-", "8-2": "-", "9-2": "-", "10-1": "Olympic", "11-1": "Olympic", "12-1": "Points List", "13-1": "Points List", "14-1": "World Triathlon Series", "15-1": "World Triathlon Series", "15-0": "[16](http://public.api.triathlon.org/v1/rankings/16)", "16-0": "[17](http://public.api.triathlon.org/v1/rankings/17)", "17-0": "[18](http://public.api.triathlon.org/v1/rankings/18)", "16-1": "Duathlon", "17-1": "Duathlon", "18-0": "[19](http://public.api.triathlon.org/v1/rankings/19)", "18-1": "Long Distance Triathlon", "19-0": "[20](http://public.api.triathlon.org/v1/rankings/20)", "19-1": "Long Distance Triathlon", "20-0": "[21](http://public.api.triathlon.org/v1/rankings/21)", "20-1": "Junior Continental", "21-0": "[22](http://public.api.triathlon.org/v1/rankings/22)", "21-1": "Junior Continental", "22-0": "[23](http://public.api.triathlon.org/v1/rankings/23)", "20-2": "Americas", "20-3": "Junior Men", "21-2": "Americas", "21-3": "Junior Women", "22-1": "Junior Continental", "23-1": "Junior Continental", "22-2": "Europe", "23-2": "Europe", "22-3": "Junior Men", "23-3": "Junior Women", "23-0": "[24](http://public.api.triathlon.org/v1/rankings/24)", "24-0": "[25](http://public.api.triathlon.org/v1/rankings/25)", "24-1": "Winter Triathlon", "25-0": "[26](http://public.api.triathlon.org/v1/rankings/26)", "25-1": "Winter Triathlon", "26-1": "Continental Rankings", "26-0": "[27](http://public.api.triathlon.org/v1/rankings/27)", "27-0": "[28](http://public.api.triathlon.org/v1/rankings/28)", "27-1": "Continental Rankings", "26-2": "Europe", "26-3": "Elite Men", "27-2": "Europe", "27-3": "Elite Women", "28-0": "[29](http://public.api.triathlon.org/v1/rankings/29)", "29-0": "[30](http://public.api.triathlon.org/v1/rankings/30)", "30-0": "[31](http://public.api.triathlon.org/v1/rankings/31)", "31-0": "[32](http://public.api.triathlon.org/v1/rankings/32)", "32-0": "[33](http://public.api.triathlon.org/v1/rankings/33)", "33-0": "[34](http://public.api.triathlon.org/v1/rankings/34)", "28-1": "Paralympic Qualification", "29-1": "Paralympic Qualification", "30-1": "Paralympic Qualification", "31-1": "Paralympic Qualification", "32-1": "Paralympic Qualification", "33-1": "Paralympic Qualification", "28-3": "Female PT2", "29-3": "Female PT4", "30-3": "Female PT5", "31-3": "Male PT1", "32-3": "Male PT2", "33-3": "Male PT4", "34-0": "[35](http://public.api.triathlon.org/v1/rankings/35)", "35-0": "[36](http://public.api.triathlon.org/v1/rankings/36)", "36-0": "[37](http://public.api.triathlon.org/v1/rankings/37)", "37-0": "[38](http://public.api.triathlon.org/v1/rankings/38)", "38-0": "[39](http://public.api.triathlon.org/v1/rankings/39)", "39-0": "[40](http://public.api.triathlon.org/v1/rankings/40)", "40-0": "[41](http://public.api.triathlon.org/v1/rankings/41)", "41-0": "[42](http://public.api.triathlon.org/v1/rankings/42)", "42-0": "[43](http://public.api.triathlon.org/v1/rankings/43)", "43-0": "[44](http://public.api.triathlon.org/v1/rankings/44)", "34-1": "Continental Points List", "34-2": "Europe", "35-2": "Europe", "36-2": "Americas", "37-2": "Americas", "38-2": "Africa", "39-2": "Africa", "40-2": "Asia", "41-2": "Asia", "42-2": "Oceania", "43-2": "Oceania", "35-1": "Continental Points List", "36-1": "Continental Points List", "37-1": "Continental Points List", "38-1": "Continental Points List", "39-1": "Continental Points List", "40-1": "Continental Points List", "41-1": "Continental Points List", "42-1": "Continental Points List", "43-1": "Continental Points List", "10-2": "-", "11-2": "-", "12-2": "-", "13-2": "-", "14-2": "-", "15-2": "-", "16-2": "-", "17-2": "-", "18-2": "-", "19-2": "-", "24-2": "-", "25-2": "-", "28-2": "-", "29-2": "-", "30-2": "-", "31-2": "-", "32-2": "-", "33-2": "-", "10-3": "Elite Men", "12-3": "Elite Men", "14-3": "Elite Men", "16-3": "Elite Men", "18-3": "Elite Men", "24-3": "Elite Men", "34-3": "Elite Men", "36-3": "Elite Men", "38-3": "Elite Men", "40-3": "Elite Men", "42-3": "Elite Men", "11-3": "Elite Women", "13-3": "Elite Women", "15-3": "Elite Women", "17-3": "Elite Women", "19-3": "Elite Women", "25-3": "Elite Women", "35-3": "Elite Women", "37-3": "Elite Women", "39-3": "Elite Women", "41-3": "Elite Women", "43-3": "Elite Women" }, "cols": 4, "rows": 44 } [/block]