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

Matches

Matches

Operations

Teams

Teams

Operations

Players

Players

Operations

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations

Odds

Odds

Operations

Get bookmakers

Request

Returns a list of available bookmakers

Security
bearerAuth
curl -i -X GET \
  https://docs.goalise.com/_mock/apireference/openapi/bookmakers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of bookmakers

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 bets

Request

Returns a list of available bets for matches

Security
bearerAuth
curl -i -X GET \
  https://docs.goalise.com/_mock/apireference/openapi/bets \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of available bets

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 live bets

Request

Returns a list of available live-bets for matches

Security
bearerAuth
curl -i -X GET \
  https://docs.goalise.com/_mock/apireference/openapi/live-bets \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of available live-bets

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 pre-match odds

Request

Returns odds information for matches

Security
bearerAuth
Query
idinteger

Match ID

league_idinteger

League ID

datestring

Date (Y-m-d)

Example: date=2025-06-18
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/odds?id=0&league_id=0&date=2025-06-18' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful operation

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 live odds

Request

Returns live odds information for live matches

Security
bearerAuth
curl -i -X GET \
  https://docs.goalise.com/_mock/apireference/openapi/live-odds \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful operation

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": [
    { … }
  ]
}