---
updatedAt: 2025-09-26T18:48:10.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/more-sports/llms.txt
---
# Rankings
**Cycling Rankings** returns competitor rankings for the current week.
### Update Frequency
300s Time To Live / Cache
***
## Data Points
| Attribute | Parent Element | Type | Description |
| -------------- | ----------------------------------- | ------ | ------------------------------------------------------------------------ |
| `abbreviation` | `competitor_ranking` - `competitor` | String | Abbreviation for a competitor name
ex. `POG` (Pogacar, Tadej) |
| `id` | `competitor_ranking` - `competitor` | String | Unique ID for a competitor
ex. `sr:competitor:507514` |
| `name` | `competitor_ranking` - `competitor` | String | Name for a competitor
ex. `Pogacar, Tadej` |
| Attribute | Parent Element | Type | Description |
| ------------------ | -------------------- | ------- | ----------------------------------------------------------------------------- |
| `points` | `competitor_ranking` | Integer | Number of points for a competitor
ex. `2666.57` |
| `rank` | `competitor_ranking` | Integer | Competitor rank |
| `ranking_movement` | `competitor_ranking` | Integer | Change in a competitor's rank from the previous week
ex. `1`, `-1` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ------- | ---------------------------------------------------------- |
| `name` | `ranking` | String | Name of a league
ex. `Individual World Ranking` |
| `type_id` | `ranking` | Integer | ID for a rankings type |
| `week` | `ranking` | Integer | Week number of the rankings |
| `year` | `ranking` | Integer | Year of the rankings |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "cycling",
"version": "2"
},
"servers": [
{
"url": "https://api.sportradar.com/cycling/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v2/{language_code}/rankings.{format}": {
"get": {
"summary": "Rankings",
"description": "**Cycling Rankings** returns competitor rankings for the current week.",
"operationId": "cycling-rankings",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`trial`, `production`",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`de` (German), `en` (English), `it` (Italian), `nl` (Dutch)
Click [here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx) for valid language codes and a tabular list of available languages per competition.",
"schema": {
"type": "string",
"enum": [
"de",
"en",
"it",
"nl"
],
"default": "en"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"generated_at\": \"2023-05-09T19:18:12.848Z\",\n \"rankings\": [\n {\n \"competitor_rankings\": [\n {\n \"competitor\": {\n \"abbreviation\": \"string\",\n \"country_code\": \"string\",\n \"gender\": \"female\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"nationality\": \"string\"\n },\n \"points\": 0,\n \"rank\": 0,\n \"ranking_movement\": 0\n }\n ],\n \"name\": \"string\",\n \"type_id\": 0,\n \"week\": 0,\n \"year\": 0\n }\n ],\n \"schema\": \"string\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2023-05-09T19:18:12.848Z"
},
"rankings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"competitor_rankings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"competitor": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "female"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
}
}
},
"points": {
"type": "integer",
"example": 0,
"default": 0
},
"rank": {
"type": "integer",
"example": 0,
"default": 0
},
"ranking_movement": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
},
"name": {
"type": "string",
"example": "string"
},
"type_id": {
"type": "integer",
"example": 0,
"default": 0
},
"week": {
"type": "integer",
"example": 0,
"default": 0
},
"year": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
},
"schema": {
"type": "string",
"example": "string"
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```