{"__v":20,"_id":"55776c06a042551900b0034f","category":{"__v":18,"_id":"55773abaa042551900b002d5","pages":["55776c06a042551900b0034f","564a6fdf4cd0521700523edc","564b6753cc472d0d00da940e","564b78801ed5c823003eb640","564b788fcc472d0d00da942e","564b7898dda79a19000f2641","564b78bfdda79a19000f2643","564b78cd1ed5c823003eb643","564b78ebdda79a19000f2646","564b791d766d4923004e1fb3","564b7929e323d01700a5132f","564b7935766d4923004e1fb5","564b793fe323d01700a51331","564b7957cc472d0d00da9431","564b7962dda79a19000f2648","564b79b31ed5c823003eb645","564b79c31ed5c823003eb647","564b79fee323d01700a51336"],"project":"55773a5ba042551900b002cb","version":"55773a5ba042551900b002ce","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-06-09T19:12:58.040Z","from_sync":false,"order":2,"slug":"athletes-api","title":"Athletes API"},"parentDoc":null,"project":"55773a5ba042551900b002cb","user":"546d17e2eb9cfd1400dd4529","version":{"__v":17,"_id":"55773a5ba042551900b002ce","project":"55773a5ba042551900b002cb","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"],"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-06-09T22:43:18.457Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"The **Athletes API** provides access to all athlete data. This is useful in producing statistics, athlete profiles and in media requests.\n\nThe Athletes API takes several parameters from the [Events](http://apidocs.triathlon.org/v1.0/docs/events-api-overview) and [Federation](http://apidocs.triathlon.org/v1.0/docs/federation-api-overview) APIs such as `country_id` and `event_id`.\n\n[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/89a09fd2262c0beaf2c7)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1auVdDD8Rciz3p3QP7iz_150917-chicago-juniorm-web-msj-10.jpg\",\n        \"150917-chicago-juniorm-web-msj-10.jpg\",\n        \"1629\",\n        \"1084\",\n        \"#5f2f23\",\n        \"\"\n      ],\n      \"caption\": \"The Athletes API provides access to all athlete data\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Basic Athlete Object\"\n}\n[/block]\nWhen using the athlete listing call or where athletes are returned from different API calls e.g. results, start lists, or rankings a basic athlete object is returned which will always conform to the following specification. If further detail is required request the full athlete listing using the [Retrieve Athlete Information](https://developers.triathlon.org/docs/retrieve-athlete-information) API call.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n   \\\"athlete_id\\\":40887,\\n   \\\"athlete_title\\\":\\\"Gwen Jorgensen\\\",\\n   \\\"athlete_slug\\\":\\\"gwen_jorgensen\\\",\\n   \\\"athlete_edit_date\\\":\\\"2015-12-31T05:09:33+00:00\\\",\\n   \\\"athlete_first\\\":\\\"Gwen\\\",\\n   \\\"athlete_last\\\":\\\"Jorgensen\\\",\\n   \\\"athlete_country_id\\\":293,\\n   \\\"athlete_gender\\\":\\\"female\\\",\\n   \\\"athlete_yob\\\":\\\"1986\\\",\\n   \\\"validated\\\":false,\\n   \\\"athlete_profile_image\\\":\\\"http:\\\\/\\\\/www.triathlon.org\\\\/images\\\\/athlete_thumbs\\\\/Gwen_Jorgensen2.jpg\\\",\\n   \\\"athlete_noc\\\":\\\"USA\\\",\\n   \\\"athlete_country_name\\\":\\\"United States\\\",\\n   \\\"athlete_country_isoa2\\\":\\\"US\\\",\\n   \\\"athlete_listing\\\":\\\"http:\\\\/\\\\/www.triathlon.org\\\\/athletes\\\\/profile\\\\/40887\\\\/gwen_jorgensen\\\",\\n   \\\"athlete_flag\\\":\\\"https:\\\\/\\\\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\\\\/images\\\\/icons\\\\/us.png\\\",\\n   \\\"athlete_api_listing\\\":\\\"https:\\\\/\\\\/api.triathlon.org\\\\/v1\\\\/v1\\\\/athletes\\\\/40887\\\",\\n   \\\"athlete_categories\\\":[\\n      42\\n   ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Basic Athlete Object\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"athletes-api-overview","type":"basic","title":"Athletes API Overview"}

Athletes API Overview


The **Athletes API** provides access to all athlete data. This is useful in producing statistics, athlete profiles and in media requests. The Athletes API takes several parameters from the [Events](http://apidocs.triathlon.org/v1.0/docs/events-api-overview) and [Federation](http://apidocs.triathlon.org/v1.0/docs/federation-api-overview) APIs such as `country_id` and `event_id`. [![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/89a09fd2262c0beaf2c7) [block:image] { "images": [ { "image": [ "https://files.readme.io/1auVdDD8Rciz3p3QP7iz_150917-chicago-juniorm-web-msj-10.jpg", "150917-chicago-juniorm-web-msj-10.jpg", "1629", "1084", "#5f2f23", "" ], "caption": "The Athletes API provides access to all athlete data" } ] } [/block] [block:api-header] { "type": "basic", "title": "Basic Athlete Object" } [/block] When using the athlete listing call or where athletes are returned from different API calls e.g. results, start lists, or rankings a basic athlete object is returned which will always conform to the following specification. If further detail is required request the full athlete listing using the [Retrieve Athlete Information](https://developers.triathlon.org/docs/retrieve-athlete-information) API call. [block:code] { "codes": [ { "code": "{\n \"athlete_id\":40887,\n \"athlete_title\":\"Gwen Jorgensen\",\n \"athlete_slug\":\"gwen_jorgensen\",\n \"athlete_edit_date\":\"2015-12-31T05:09:33+00:00\",\n \"athlete_first\":\"Gwen\",\n \"athlete_last\":\"Jorgensen\",\n \"athlete_country_id\":293,\n \"athlete_gender\":\"female\",\n \"athlete_yob\":\"1986\",\n \"validated\":false,\n \"athlete_profile_image\":\"http:\\/\\/www.triathlon.org\\/images\\/athlete_thumbs\\/Gwen_Jorgensen2.jpg\",\n \"athlete_noc\":\"USA\",\n \"athlete_country_name\":\"United States\",\n \"athlete_country_isoa2\":\"US\",\n \"athlete_listing\":\"http:\\/\\/www.triathlon.org\\/athletes\\/profile\\/40887\\/gwen_jorgensen\",\n \"athlete_flag\":\"https:\\/\\/f9ca11ef49c28681fc01-0acbf57e00c47a50e70a1acb89e86c89.ssl.cf1.rackcdn.com\\/images\\/icons\\/us.png\",\n \"athlete_api_listing\":\"https:\\/\\/api.triathlon.org\\/v1\\/v1\\/athletes\\/40887\",\n \"athlete_categories\":[\n 42\n ]\n}", "language": "json", "name": "Basic Athlete Object" } ] } [/block]