API Documentation (2.0.7)

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server

https://docs.goalise.com/_mock/apireference/openapi/

Goalise API Server

https://api.goalise.com/api/v2/

Countries

Countries

Operations

Leagues

Leagues

Operations

Matches

Matches

Operations

Teams

Teams

Operations

Players

Players

Operations

Get player

Request

Returns detailed information about a specific player

Security
bearerAuth
Query
idintegerrequired

ID of the player

Example: id=8
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/player?id=8' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Player details response

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

Example: null
errorsobject or null
Example: null
responseobject or null

Detailed information about a football player

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "id": 101,
    "name": "Lionel Messi",
    "first_name": "Lionel",
    "last_name": "Messi",
    "position": "Forward",
    "number": 10,
    "nationality": "Argentina",
    "photo": "https://example.com/photos/messi.png",
    "age": 36,
    "birth_date": "1987-06-24",
    "birth_place": "Rosario",
    "birth_country": "Argentina",
    "height": "170 cm",
    "weight": "72 kg",
    "injured": false
  }
}

Get team players

Request

Returns a list of players associated with a specific team

Security
bearerAuth
Query
idintegerrequired

ID of the team

Example: id=69
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/team-players?id=69' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of players for the given team

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get player teams

Request

Returns a list of teams a player is part of

Security
bearerAuth
Query
idintegerrequired

ID of the player

Example: id=8
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/teams-by-player?id=8' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of teams a player is part of

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get player league statistics

Request

Returns a paginated list of player statistics in a league for a given season and team

Security
bearerAuth
Query
league_idintegerrequired

ID of the league

Example: league_id=621
player_idinteger

Filter by ID of the player

team_idintegerrequired

ID of the team

Example: team_id=69
seasonintegerrequired

Season year

Example: season=2024
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/player-statistics?league_id=621&player_id=0&season=2024&team_id=69' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Paginated response with PlayerLeagueStatisticsDetails items

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get player match statistics

Request

Returns detailed statistics for a player in a given match

Security
bearerAuth
Query
match_idintegerrequired

Match ID

Example: match_id=367878
player_idintegerrequired

Player ID

Example: player_id=7939
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/player-match-statistics?match_id=367878&player_id=7939' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Player match statistics

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

Example: null
errorsobject or null
Example: null
responseobject or null

Represents a player's performance statistics in a match

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "cards": { … },
    "duels": { … },
    "fouls": { … },
    "games": { … },
    "goals": { … },
    "shots": { … },
    "passes": { … },
    "penalty": { … },
    "tackles": { … },
    "dribbles": { … },
    "offsides": null
  }
}

Get top scorers

Request

Returns a list of top scoring players for a given league and season

Security
bearerAuth
Query
league_idintegerrequired

League ID

Example: league_id=621
seasonintegerrequired

Season

Example: season=2024
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-scorers?league_id=621&season=2024' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of top scorers

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get top assists

Request

Returns a list of top assisting players for a given league and season

Security
bearerAuth
Query
league_idintegerrequired

League ID

Example: league_id=621
seasonintegerrequired

Season year

Example: season=2024
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-assists?league_id=621&season=2024' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of top assists

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get top red cards

Request

Returns a list of players who received the most red cards in a given league and season

Security
bearerAuth
Query
league_idintegerrequired

League ID

Example: league_id=621
seasonintegerrequired

Season year

Example: season=2024
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-red-cards?league_id=621&season=2024' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of players with the most red cards

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get top yellow cards

Request

Returns a list of players who received the most yellow cards in a given league and season

Security
bearerAuth
Query
league_idintegerrequired

League ID

Example: league_id=621
seasonintegerrequired

Season year

Example: season=2024
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-yellow-cards?league_id=621&season=2024' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of players with the most yellow cards

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations

Odds

Odds

Operations