API Documentation (2.0.7)

Download OpenAPI description

openapi.json

openapi.yaml

Servers

Mock server

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

Goalise API Server

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

Countries

Operations

Leagues

Operations

Matches

Operations

Teams

Operations

Players

Operations

Get player

Request

Returns detailed information about a specific player

Query

idintegerrequired

ID of the player

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

Responses

Player details response

Bodyapplication/json

statusstring

Example: "success"

paginationobject or null

Pagination info if applicable

errorsobject or null

Example: null

responseobject or null

Detailed information about a football player

Response

application/json

{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": {
    "0": {},
    "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

Query

idintegerrequired

ID of the team

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/team-players?id=0' \
  -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

Query

idintegerrequired

ID of the player

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/player-teams?id=0' \
  -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

Query

league_idintegerrequired

ID of the league

player_idintegerrequired

ID of the player

team_idintegerrequired

ID of the team

seasonintegerrequired

Season year (e.g. 2024)

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/player-statistics?league_id=0&player_id=0&season=0&team_id=0' \
  -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

Query

match_idintegerrequired

Match ID

player_idintegerrequired

Player ID

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

Responses

Player match statistics

Bodyapplication/json

statusstring

Example: "success"

paginationobject or null

Pagination info if applicable

errorsobject or null

Example: null

responseobject or null

Represents a player's performance statistics in a match

Response

application/json

{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": {
    "0": {},
    "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

Query

league_idintegerrequired

League ID

seasonintegerrequired

Season

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-scorers?league_id=0&season=0' \
  -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

Query

league_idintegerrequired

League ID

seasonintegerrequired

Season year

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-assists?league_id=0&season=0' \
  -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

Query

league_idintegerrequired

League ID

seasonintegerrequired

Season year

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-red-cards?league_id=0&season=0' \
  -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

Query

league_idintegerrequired

League ID

seasonintegerrequired

Season year

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/top-yellow-cards?league_id=0&season=0' \
  -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

Operations

Venues

Operations

Predictions

Operations

News

Operations

API Documentation (2.0.7)

Countries

Leagues

Matches

Teams

Players

Get player

Request

Responses

Was this helpful?

Get team players

Request

Responses

Was this helpful?

Get player teams

Request

Responses

Was this helpful?

Get player league statistics

Request

Responses

Was this helpful?

Get player match statistics

Request

Responses

Was this helpful?

Get top scorers

Request

Responses

Was this helpful?

Get top assists

Request

Responses

Was this helpful?

Get top red cards

Request

Responses

Was this helpful?

Get top yellow cards

Request

Responses

Was this helpful?

Transfers

Venues

Predictions

News