Skip to content

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

Get league

Request

Security
bearerAuth
Query
idintegerrequired

The unique identifier of the league

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

Responses

Successful response with a league object

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

Pagination info if applicable

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

Represents a football league with relevant information.

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "id": 1,
    "name": "Premier League",
    "type": "league",
    "current_season": "2025",
    "current_round": "Round 1",
    "country": { … },
    "coverage": { … }
  }
}

Get leagues

Request

Security
bearerAuth
Query
country_idinteger

Filter leagues by Country ID

Example: country_id=20
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/leagues?country_id=20&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful response with a list of leagues

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": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get league seasons

Request

Returns a list of seasons for a specific league based on the league ID

Security
bearerAuth
Query
idintegerrequired

The unique identifier of the league

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

Responses

List of seasons for the league

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

Pagination info if applicable

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

Get league rounds

Request

Returns a list of rounds for a specific league and season

Security
bearerAuth
Query
league_idinteger

League ID

Example: league_id=618
seasoninteger

Season

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

Responses

List of rounds for the league and season

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

Pagination info if applicable

errorsobject or null
Example: null
responseArray of strings or null
Example: ["Regular Season - 1"]
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    "Regular Season - 1"
  ]
}

Get league standings

Request

Returns grouped league standings for a given league. If no season is provided, current season will be used.

Security
bearerAuth
Query
idintegerrequired

League ID

Example: id=618
seasoninteger

Season year (optional, defaults to current)

Example: season=2024
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/league-standing?id=618&season=2024' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Grouped standings for the given league and season

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

Pagination info if applicable

Example: null
errorsobject or null
Example: null
responseArray of objects or null

Array of standing groups, where each group contains multiple standing entries

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": [
    [ … ]
  ]
}

Matches

Matches

Operations

Teams

Teams

Operations

Players

Players

Operations

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations

Odds

Odds

Operations