API Documentation (2.0.7)

Download OpenAPI description
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