GET /v4/leagues/list
GET
https://api.kickbase.com/v4/leagues/list
List Leagues
Query Parameters
| Parameter | Type | Description |
|---|---|---|
query | string | Optional search string to filter leagues by name. |
competitionId | string | Filter leagues by a specific competition ID (e.g. 1 for Kickbase, 3 for LaLiga). |
gameplayMode | string | Filter leagues by gameplay mode. |
start | integer | Pagination offset — the index of the first result to return. |
max | integer | Maximum number of results to return per page. |
Response Structure
it array, where each element represents a league.Top-level fields
| Field | Type | Description |
|---|---|---|
it | array | List of league objects. |
League object fields (it[])
| Field | Type | Description |
|---|---|---|
li | string | Unique league ID. |
lnm | string | League name. |
cpi | string | Competition ID the league belongs to (e.g. "1" = Kickbase, "3" = LaLiga). |
mgc | integer | Current matchday count (number of matchdays played so far). |
mgm | integer | Maximum number of matchdays in the season. |
cpim | string | Relative path to the competition's image/logo asset. |
lim | string | (Optional) Relative path to the league's custom image/logo asset. Only present if a custom league image has been set. |
Example Response
{
"it": [
{
"li": "10000024",
"lnm": "LaLiga",
"cpi": "3",
"mgc": 1,
"mgm": 18,
"lim": "league/00a6a371d97d482b91edf5e6b4deedca",
"cpim": "content/file/7f86a70eb6644df8865f3ef7e22..."
},
{
"li": "9995971",
"lnm": "Bundesliga",
"cpi": "1",
"mgc": 3,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db3..."
}
]
}
Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.kickbase.com/v4/leagues/list?query=&competitionId=&gameplayMode=&start=&max=' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"it": [
{
"li": "10000625",
"lnm": "Uncs",
"cpi": "1",
"mgc": 1,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "10000431",
"lnm": "meine Liga",
"cpi": "3",
"mgc": 1,
"mgm": 18,
"cpim": "content/file/7f86a70eb6644df8865f3ef7e2262379.png"
},
{
"li": "10000031",
"lnm": "LaLiga",
"cpi": "3",
"mgc": 1,
"mgm": 18,
"cpim": "content/file/7f86a70eb6644df8865f3ef7e2262379.png"
},
{
"li": "10000030",
"lnm": "LaLiga",
"cpi": "3",
"mgc": 1,
"mgm": 18,
"cpim": "content/file/7f86a70eb6644df8865f3ef7e2262379.png"
},
{
"li": "10000029",
"lnm": "LaLiga",
"cpi": "3",
"mgc": 1,
"mgm": 18,
"cpim": "content/file/7f86a70eb6644df8865f3ef7e2262379.png"
},
{
"li": "10000024",
"lnm": "LaLiga",
"cpi": "3",
"mgc": 1,
"mgm": 18,
"lim": "league/00a6a371d97d482b91edf5e6b4deedca.png",
"cpim": "content/file/7f86a70eb6644df8865f3ef7e2262379.png"
},
{
"li": "10000026",
"lnm": "LaLiga",
"cpi": "3",
"mgc": 2,
"mgm": 18,
"lim": "league/d5601f418cd64f41b924bf7da0b08198.png",
"cpim": "content/file/7f86a70eb6644df8865f3ef7e2262379.png"
},
{
"li": "9997044",
"lnm": "points",
"cpi": "1",
"mgc": 3,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9995971",
"lnm": "Bundesliga",
"cpi": "1",
"mgc": 3,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9997091",
"lnm": "Champions",
"cpi": "1",
"mgc": 4,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9996950",
"lnm": "1. Bundesliga 25/26 ab Spieltag 24",
"cpi": "1",
"mgc": 4,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9997060",
"lnm": "Punkte",
"cpi": "1",
"mgc": 4,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9994486",
"lnm": "Anfänger trupp",
"cpi": "1",
"mgc": 6,
"mgm": 18,
"lim": "league/a81102ab0d0144be951d8df20fb4690c.png",
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9996949",
"lnm": "1. Bundesliga 25/26 ab Spieltag 24",
"cpi": "1",
"mgc": 6,
"mgm": 18,
"lim": "league/8d456a96d1dd409e939eb8d9ba2f1ee8.png",
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9959095",
"lnm": "Berka kicker",
"cpi": "1",
"mgc": 6,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9956931",
"lnm": "VfB Stuttgart",
"cpi": "1",
"mgc": 7,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9975273",
"lnm": "1",
"cpi": "1",
"mgc": 7,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9956461",
"lnm": "maza",
"cpi": "1",
"mgc": 7,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9984216",
"lnm": "dbsgbehnur",
"cpi": "1",
"mgc": 8,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9773982",
"lnm": "18er Hardcore liga",
"cpi": "1",
"mgc": 7,
"mgm": 18,
"lim": "league/23eaddc3e0be457b83ca2d982e29adfe.png",
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9956862",
"lnm": "er",
"cpi": "1",
"mgc": 7,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9623698",
"lnm": "1 Bundesliga ",
"cpi": "1",
"mgc": 7,
"mgm": 18,
"lim": "league/584c5cbd246e4e2fa30a7d6df49268ed.png",
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9957979",
"lnm": "Buli aktiv",
"cpi": "1",
"mgc": 8,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9925828",
"lnm": "FOS242",
"cpi": "1",
"mgc": 5,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
},
{
"li": "9993313",
"lnm": "Bundesliga",
"cpi": "1",
"mgc": 9,
"mgm": 18,
"cpim": "content/file/a9eb2919122b4e248349ba91db351901.png"
}
]
}