Kickbase

General notes

This API was published as part of kickbase-api-doc on GitHub. It is licensed under the MIT License. The purpose of this documentation is for scientific reasons only!

API detail

User

Login

Logs in a user by email and password and saves the password as an environment variable.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{
    "email": "[email]",
    "password": "[password]",
    "ext": false
}' "https://api.kickbase.com/user/login"
POST /user/login HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json

{
    "email": "[email]",
    "password": "[password]",
    "ext": false
}

Reset Password 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{
    "password": "",
    "token": ""
}' "https://api.kickbase.com/user/resetpassword"
POST /user/resetpassword HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json

{
    "password": "",
    "token": ""
}

League User Info 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/me"
GET /leagues/[league_id]/me HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

User Match Day Feed 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/users/[user_id]/feed"
GET /leagues/[league_id]/users/[user_id]/feed HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Refresh Chat Token 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/user/refreshchattoken"
POST /user/refreshchattoken HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Player

Player Info 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/players/[player_id]/"
GET /leagues/[league_id]/players/[player_id]/ HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Player Feed 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/players/[player_id]/feed"
GET /leagues/[league_id]/players/[player_id]/feed HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Player Points 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/players/[player_id]/points"
GET /players/[player_id]/points HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Player Stats 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/players/[player_id]/stats"
GET /leagues/[league_id]/players/[player_id]/stats HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Search Competition Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/competition/search?query="
GET /competition/search?query= HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Market

Remove Player From Market 

curl -X DELETE -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/market/[player_id]"
DELETE /leagues/[league_id]/market/[player_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Market 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/market/"
GET /leagues/[league_id]/market/ HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Add Player To Market 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "playerId": "663",
    "price": 6000000
}' "https://api.kickbase.com/leagues/[league_id]/market"
POST /leagues/[league_id]/market HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "playerId": "663",
    "price": 6000000
}

Accept Offer 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/market/[player_id]/offers/[offer_id]/accept"
POST /leagues/[league_id]/market/[player_id]/offers/[offer_id]/accept HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Update Price 

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "price": 6000000
}' "https://api.kickbase.com/leagues/[league_id]/market/[player_id]"
PUT /leagues/[league_id]/market/[player_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "price": 6000000
}

Decline Offer 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "playerId": "663",
    "price": 6000000
}' "https://api.kickbase.com/leagues/[league_id]/market/[player_id]/offers/[offer_id]/decline"
POST /leagues/[league_id]/market/[player_id]/offers/[offer_id]/decline HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "playerId": "663",
    "price": 6000000
}

Place Offer 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "price": 6000000
}' "https://api.kickbase.com/leagues/[league_id]/market/[player_id]/offers"
POST /leagues/[league_id]/market/[player_id]/offers HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "price": 6000000
}

Remove Offer 

curl -X DELETE -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/market/[player_id]/offers/[offer_id]/"
DELETE /leagues/[league_id]/market/[player_id]/offers/[offer_id]/ HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Lineup

Lineup 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/lineup"
GET /leagues/[league_id]/lineup HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Lineup Extended 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/lineupex"
GET /leagues/[league_id]/lineupex HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Ligainsider 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/sso/ligainsider?leagueId=[league_id]"
POST /sso/ligainsider?leagueId=[league_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Set Lineup 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
   "type":"3-4-3",
   "players":[
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null
   ]
}' "https://api.kickbase.com/leagues/[league_id]/lineup"
POST /leagues/[league_id]/lineup HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
   "type":"3-4-3",
   "players":[
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      null
   ]
}

Live Match Day

Chat History 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/live/chat?start=0"
GET /leagues/[league_id]/live/chat?start=0 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Overview 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/live/"
GET /leagues/[league_id]/live/ HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Events History 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/live/matches/[match_id]"
GET /leagues/[league_id]/live/matches/[match_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Not Lined Up Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/live/notlinedupplayers"
GET /leagues/[league_id]/live/notlinedupplayers HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Player History 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/live/players/[player_id]"
GET /leagues/[league_id]/live/players/[player_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Top 10 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/live/top10"
GET /live/top10 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Team Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/live/teams/[team_id]/players"
GET /live/teams/[team_id]/players HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Team Ranking 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/live/teamranking"
GET /live/teamranking HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Chat Message 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "m": "Test"
}' "https://api.kickbase.com/leagues/[league_id]/live/chat"
POST /leagues/[league_id]/live/chat HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "m": "Test"
}

League

Leagues 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/"
GET /leagues/ HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Feed Comments 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/feed/[feed_item_id]/comments"
GET /leagues/[league_id]/feed/[feed_item_id]/comments HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Feed 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/feed?start=0"
GET /leagues/[league_id]/feed?start=0 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Info 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/info"
GET /leagues/[league_id]/info HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Players For Match Day 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/users/[user_id]/players?matchDay=0"
GET /leagues/[league_id]/users/[user_id]/players?matchDay=0 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Stats 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/stats"
GET /leagues/[league_id]/stats HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Users 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/users"
GET /leagues/[league_id]/users HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

User Profile 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/users/[user_id]/profile"
GET /leagues/[league_id]/users/[user_id]/profile HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

User Stats 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/users/[user_id]/stats"
GET /leagues/[league_id]/users/[user_id]/stats HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

User Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/users/[user_id]/players"
GET /leagues/[league_id]/users/[user_id]/players HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Me 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/me"
GET /leagues/[league_id]/me HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Quickstats 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/quickstats"
GET /leagues/[league_id]/quickstats HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Comment Feed 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "comment": "Test"
}' "https://api.kickbase.com/leagues/[league_id]/feed/[feed_item_id]/comments"
POST /leagues/[league_id]/feed/[feed_item_id]/comments HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "comment": "Test"
}

Comment League 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" -d '{
    "comment": "Test"
}' "https://api.kickbase.com/leagues/[league_id]/feed"
POST /leagues/[league_id]/feed HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

{
    "comment": "Test"
}

Competition

Add Favorite Player 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/user/favoriteplayers/[player_id]"
POST /user/favoriteplayers/[player_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Remove Favorite Player 

curl -X DELETE -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/user/favoriteplayers/[player_id]"
DELETE /user/favoriteplayers/[player_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Top 25 Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" "https://api.kickbase.com/competition/best?position=0"
GET /competition/best?position=0 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json

Matches 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/competition/matches?matchDay=20"
GET /competition/matches?matchDay=20 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Table 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/competition/table?matchDay=30"
GET /competition/table?matchDay=30 HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Team Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/competition/teams/[team_id]/players"
GET /competition/teams/[team_id]/players HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Search Players 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/competition/search?t=Lewandowski"
GET /competition/search?t=Lewandowski HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Gift

Collect 

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/collectgift"
POST /leagues/[league_id]/collectgift HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Current Gift 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/leagues/[league_id]/currentgift"
GET /leagues/[league_id]/currentgift HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Achievements

Achivements 

curl -X GET -H "Content-Type: application/json" -H "Accept: application/json" -H "Cookie: kkstrauth=[token];" "https://api.kickbase.com/user/achievements?league_id=[league_id]"
GET /user/achievements?league_id=[league_id] HTTP/1.1
Host: api.kickbase.com
Content-Type: application/json
Accept: application/json
Cookie: kkstrauth=[token];

Chat

Exchange Custom Token 

curl -X POST -d '{
    "returnSecureToken": true,
    "token": "[chat_token]"
}' "https://www.googleapis.com/identitytoolkit/v3/relyingparty/verifyCustomToken?key=[api_key]"
POST /identitytoolkit/v3/relyingparty/verifyCustomToken?key=[api_key] HTTP/1.1
Host: www.googleapis.com

{
    "returnSecureToken": true,
    "token": "[chat_token]"
}

Post Message 

curl -X POST -H "Authorization: Bearer [firebase_id_token]" -d '{
     "fields": {
        "userId": {
          "stringValue": "[user_id]"
        },
        "message": {
          "stringValue": "Hello World!"
        },
        "leagueId": {
          "stringValue": "[league_id]"
        },
        "date": {
          "stringValue": "2020-08-17T19:13:04Z"
        },
        "username": {
          "stringValue": ""
        },
         "seenBy": {
          "arrayValue": {
            "values": [
              {
                "stringValue": "[user_id]"
              }
            ]
          }
        }
     }
}' "https://firestore.googleapis.com/v1/projects/kickbase-bdb0f/databases/(default)/documents/chat/[league_id]/messages"
POST /v1/projects/kickbase-bdb0f/databases/(default)/documents/chat/[league_id]/messages HTTP/1.1
Host: firestore.googleapis.com
Authorization: Bearer [firebase_id_token]

{
     "fields": {
        "userId": {
          "stringValue": "[user_id]"
        },
        "message": {
          "stringValue": "Hello World!"
        },
        "leagueId": {
          "stringValue": "[league_id]"
        },
        "date": {
          "stringValue": "2020-08-17T19:13:04Z"
        },
        "username": {
          "stringValue": ""
        },
         "seenBy": {
          "arrayValue": {
            "values": [
              {
                "stringValue": "[user_id]"
              }
            ]
          }
        }
     }
}

Get Messages 

curl -X GET -H "Authorization: Bearer [firebase_id_token]" "https://firestore.googleapis.com/v1/projects/kickbase-bdb0f/databases/(default)/documents/chat/[league_id]/messages"
GET /v1/projects/kickbase-bdb0f/databases/(default)/documents/chat/[league_id]/messages HTTP/1.1
Host: firestore.googleapis.com
Authorization: Bearer [firebase_id_token]