--- updatedAt: 2025-06-11T20:14:47.000Z agentTools: projectIndex: https://developers.triathlon.org/llms.txt --- # Athlete Ranking Breakdown This **Athlete Ranking Breakdown** method returns detailed ranking information for an athlete. It provides the result of all events that are contained within a ranking criteria and contains detailed information as to the status of that event. A basic athlete object and ranking listing object are returned with all rankings details contained within the breakdown object. The output of the breakdown object is ranking specific and you should consult each [ranking criteria](http://www.triathlon.org/about/downloads/category/ranking_criteria) for more information but the following guidelines may be used: > 🚧 Periods are statically defined > > The terms current period and previous period are statically defined; they will always refer to the first period and second period for scoring. * For events with multiple periods the current period is designated as 1 and the prior period 2. * The event type corresponds to the points level listed on each ranking criteria which is used to determine the number of scoring positions and maximum number of points. * For some ranking criteria the results of the event are modified according to the ranking criteria (e.g. where non-continental athletes are in the results of a Continental event). In these cases the prog\_id refers to the results used and the original results are available in the **override\_prog\_id**. Similarly the override\_prog\_time and original\_position may be used for the raw non-modified data. * The boolean **include** value displays whether this score has been included in the ranking score * For events that are within a separate event e.g. a National Championship event taking place in a Continental Cup the **event\_container** key will show the event\_id of the containing event. * If the event has been modified and a deduction is applicable the % deduction will be shown * The **notes** key contains specific information as to why the score has not been included if applicable For further information about each event you may also consult the [Ranking Events](https://triathlon-api.readme.io/docs/ranking-events) method. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "triathlon-api-v1", "version": "1" }, "servers": [ { "url": "https://api.triathlon.org/v1" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "apikey", "x-default": "2649776ef9ece4c391003b521cbfce7a" } } }, "security": [ { "sec0": [] } ], "paths": { "/rankings/{ranking_id}/breakdown/{athlete_id}": { "get": { "summary": "Athlete Ranking Breakdown", "description": "", "operationId": "athlete-ranking-breakdown", "parameters": [ { "name": "ranking_id", "in": "path", "description": "The id of the ranking", "required": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "athlete_id", "in": "path", "description": "The id of the athlete", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"code\":200,\n \"status\":\"success\",\n \"data\":{\n \"ranking_id\":1,\n \"ranking_name\":\"Men's PT1\",\n \"ranking_cat_id\":1,\n \"ranking_category_name\":\"Paratriathlon\",\n \"published\":\"2015-11-06 19:35:36\",\n \"region_id\":null,\n \"week\":\"2015-W45\",\n \"region_name\":null,\n \"rankings\":{\n \"rank\":1,\n \"last_rank\":1,\n \"change\":0,\n \"last_week_score\":1800,\n \"athlete_id\":32627,\n \"athlete_slug\":\"bill_chaffey\",\n \"athlete_first\":\"Bill\",\n \"athlete_last\":\"Chaffey\",\n \"athlete_nat\":\"AUS\",\n \"athlete_flag\":\"https:\\/\\/cdn.triathlon.org\\/images\\/icons\\/au.png\",\n \"athlete_yob\":\"1975\",\n \"total_score\":1800,\n \"score_current_period\":1450,\n \"score_prev_period\":350,\n \"events_current_period\":3,\n \"events_prev_period\":3,\n \"current_period_1\":700,\n \"current_period_2\":450,\n \"current_period_3\":300,\n \"prev_period_1\":150,\n \"prev_period_2\":100,\n \"prev_period_3\":100\n },\n \"breakdown\":[\n {\n \"event_id\":90168,\n \"event_title\":\"2015 ITU World Triathlon Grand Final Chicago\",\n \"event_slug\":\"2015_itu_world_triathlon_grand_final_chicago\",\n \"event_date\":\"2015-09-15\",\n \"event_type\":1,\n \"prog_id\":272186,\n \"points\":700,\n \"position\":1,\n \"total_time\":\"00:58:38\",\n \"notes\":\"\",\n \"period\":1,\n \"event_container\":0,\n \"override_prog_id\":0,\n \"override_prog_time\":\"\",\n \"event_deduction\":0,\n \"original_position\":\"\",\n \"include\":true\n }\n ]\n }\n}" } }, "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 200, "default": 0 }, "status": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "ranking_id": { "type": "integer", "example": 1, "default": 0 }, "ranking_name": { "type": "string", "example": "Men's PT1" }, "ranking_cat_id": { "type": "integer", "example": 1, "default": 0 }, "ranking_category_name": { "type": "string", "example": "Paratriathlon" }, "published": { "type": "string", "example": "2015-11-06 19:35:36" }, "region_id": {}, "week": { "type": "string", "example": "2015-W45" }, "region_name": {}, "rankings": { "type": "object", "properties": { "rank": { "type": "integer", "example": 1, "default": 0 }, "last_rank": { "type": "integer", "example": 1, "default": 0 }, "change": { "type": "integer", "example": 0, "default": 0 }, "last_week_score": { "type": "integer", "example": 1800, "default": 0 }, "athlete_id": { "type": "integer", "example": 32627, "default": 0 }, "athlete_slug": { "type": "string", "example": "bill_chaffey" }, "athlete_first": { "type": "string", "example": "Bill" }, "athlete_last": { "type": "string", "example": "Chaffey" }, "athlete_nat": { "type": "string", "example": "AUS" }, "athlete_flag": { "type": "string", "example": "https://cdn.triathlon.org/images/icons/au.png" }, "athlete_yob": { "type": "string", "example": "1975" }, "total_score": { "type": "integer", "example": 1800, "default": 0 }, "score_current_period": { "type": "integer", "example": 1450, "default": 0 }, "score_prev_period": { "type": "integer", "example": 350, "default": 0 }, "events_current_period": { "type": "integer", "example": 3, "default": 0 }, "events_prev_period": { "type": "integer", "example": 3, "default": 0 }, "current_period_1": { "type": "integer", "example": 700, "default": 0 }, "current_period_2": { "type": "integer", "example": 450, "default": 0 }, "current_period_3": { "type": "integer", "example": 300, "default": 0 }, "prev_period_1": { "type": "integer", "example": 150, "default": 0 }, "prev_period_2": { "type": "integer", "example": 100, "default": 0 }, "prev_period_3": { "type": "integer", "example": 100, "default": 0 } } }, "breakdown": { "type": "array", "items": { "type": "object", "properties": { "event_id": { "type": "integer", "example": 90168, "default": 0 }, "event_title": { "type": "string", "example": "2015 ITU World Triathlon Grand Final Chicago" }, "event_slug": { "type": "string", "example": "2015_itu_world_triathlon_grand_final_chicago" }, "event_date": { "type": "string", "example": "2015-09-15" }, "event_type": { "type": "integer", "example": 1, "default": 0 }, "prog_id": { "type": "integer", "example": 272186, "default": 0 }, "points": { "type": "integer", "example": 700, "default": 0 }, "position": { "type": "integer", "example": 1, "default": 0 }, "total_time": { "type": "string", "example": "00:58:38" }, "notes": { "type": "string", "example": "" }, "period": { "type": "integer", "example": 1, "default": 0 }, "event_container": { "type": "integer", "example": 0, "default": 0 }, "override_prog_id": { "type": "integer", "example": 0, "default": 0 }, "override_prog_time": { "type": "string", "example": "" }, "event_deduction": { "type": "integer", "example": 0, "default": 0 }, "original_position": { "type": "string", "example": "" }, "include": { "type": "boolean", "example": true, "default": true } } } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```