GET /v4/competitions/{competitionId}/ranking
GET
https://api.kickbase.com/v4/competitions/{competitionId}/ranking
Get Competition Ranking
Path Variables
| Variable | Description |
|---|---|
competitionId | (Required) The unique identifier of the competition whose ranking you want to retrieve. Set via the {{competitionId}} environment variable. |
Authentication
{{token}} variable must be set in the active environment (e.g. Kickbase v4) with a valid access token obtained from the login endpoint.Response
200 OK — Returns a JSON object with an it array, where each item represents a team entry in the ranking.| Field | Type | Description |
|---|---|---|
tid | string | Unique team ID |
tn | string | Team name |
mdpl | number | Match-day placement (rank for the current match day) |
spl | number | Season placement (overall season rank) |
mdp | number | Match-day points scored |
sp | number | Total season points |
il | boolean | Indicates if the team is inactive/locked |
tim | string | Relative path to the team's logo image |
{
"it": [
{
"tid": "2",
"tn": "Bayern",
"mdpl": 2,
"spl": 1,
"mdp": 1920,
"sp": 49529,
"il": false,
"tim": "content/file/ff70df040a9f4179a7b45219225a2273.svg"
}
]
}Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.kickbase.com/v4/competitions//ranking' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"it": [
{
"tid": "9",
"tn": "Stuttgart",
"mdpl": 5,
"spl": 3,
"mdp": 1716,
"sp": 33580,
"il": false,
"tim": "content/file/9a1bb78d0ccf45f895797c0c6d8c4d40.svg"
},
{
"tid": "4",
"tn": "Frankfurt",
"mdpl": 11,
"spl": 7,
"mdp": 737,
"sp": 25923,
"il": false,
"tim": "content/file/422de82bee3b47eb898699d6d27095ba.svg"
},
{
"tid": "18",
"tn": "Mainz",
"mdpl": 7,
"spl": 16,
"mdp": 1487,
"sp": 19881,
"il": false,
"tim": "content/file/d4ac9675b44944039d463837f888cb1c.svg"
},
{
"tid": "50",
"tn": "Heidenheim",
"mdpl": 12,
"spl": 18,
"mdp": 565,
"sp": 15067,
"il": false,
"tim": "content/file/f387dd39aafb47d0b4863381fc4a521c.svg"
},
{
"tid": "3",
"tn": "Dortmund",
"mdpl": 4,
"spl": 2,
"mdp": 1836,
"sp": 33930,
"il": false,
"tim": "content/file/dc3d63ae79bf4282a4107bafcd572b99.svg"
},
{
"tid": "10",
"tn": "Bremen",
"mdpl": 18,
"spl": 12,
"mdp": 251,
"sp": 21335,
"il": false,
"tim": "content/file/a7e609e72fb04c6d8c96e8ed82f0315d.svg"
},
{
"tid": "11",
"tn": "Wolfsburg",
"mdpl": 8,
"spl": 14,
"mdp": 1413,
"sp": 20736,
"il": false,
"tim": "content/file/f23d72a0cf2d48a2a29ede777110aece.svg"
},
{
"tid": "39",
"tn": "St. Pauli",
"mdpl": 13,
"spl": 17,
"mdp": 486,
"sp": 18675,
"il": false,
"tim": "content/file/cae200d5499e43c4a5c382a1fbb25435.svg"
},
{
"tid": "28",
"tn": "Köln",
"mdpl": 14,
"spl": 10,
"mdp": 435,
"sp": 22141,
"il": false,
"tim": "content/file/dca70c4089fd4623932b245c0e81eaba.svg"
},
{
"tid": "2",
"tn": "Bayern",
"mdpl": 2,
"spl": 1,
"mdp": 1920,
"sp": 49529,
"il": false,
"tim": "content/file/ff70df040a9f4179a7b45219225a2273.svg"
},
{
"tid": "14",
"tn": "Hoffenheim",
"mdpl": 1,
"spl": 6,
"mdp": 2095,
"sp": 30500,
"il": false,
"tim": "content/file/5212904732a04199aab426e44067347c.svg"
},
{
"tid": "15",
"tn": "M'gladbach",
"mdpl": 17,
"spl": 9,
"mdp": 319,
"sp": 22209,
"il": false,
"tim": "content/file/7178ef92ad0747a5ad1a05d0783f5088.svg"
},
{
"tid": "43",
"tn": "Leipzig",
"mdpl": 3,
"spl": 4,
"mdp": 1864,
"sp": 32813,
"il": false,
"tim": "content/file/29ceb88867954b548ca9e27d39d050c2.svg"
},
{
"tid": "5",
"tn": "Freiburg",
"mdpl": 16,
"spl": 8,
"mdp": 327,
"sp": 22832,
"il": false,
"tim": "content/file/6c1a9f14b668493283f966834891aa70.svg"
},
{
"tid": "13",
"tn": "Augsburg",
"mdpl": 10,
"spl": 11,
"mdp": 769,
"sp": 21769,
"il": false,
"tim": "content/file/8d68c946b9774505b8292adfa910d0a0.svg"
},
{
"tid": "40",
"tn": "Union Berlin",
"mdpl": 9,
"spl": 15,
"mdp": 859,
"sp": 19966,
"il": false,
"tim": "content/file/8f4c7c08ee9b4dca85c28260fc5917bd.svg"
},
{
"tid": "6",
"tn": "Hamburg",
"mdpl": 15,
"spl": 13,
"mdp": 402,
"sp": 20820,
"il": false,
"tim": "content/file/c9b7d8772f324f9badeb285af4c5810a.svg"
},
{
"tid": "7",
"tn": "Leverkusen",
"mdpl": 6,
"spl": 5,
"mdp": 1614,
"sp": 32181,
"il": false,
"tim": "content/file/e06a055a6eaf4fd7bebfadb35037f957.svg"
}
]
}