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

Get team

Request

Returns a single team by its ID

Security
bearerAuth
Query
idintegerrequired

ID of the team to retrieve

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

Responses

Team object returned successfully

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 team

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "id": 33,
    "name": "Manchester United",
    "logo": "https://example.com/logos/teams/manutd.png",
    "founded": "1878",
    "venue": { … },
    "country": { … }
  }
}

Get teams by league

Request

Returns a list of teams for the specified league ID

Security
bearerAuth
Query
league_idintegerrequired

The ID of the league

Example: league_id=621
seasonintegerrequired

Season

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

Responses

Successful response with a list of teams

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 team statistics

Request

Returns detailed team statistics for the specified league and season

Security
bearerAuth
Query
league_idintegerrequired

League ID

Example: league_id=621
team_idintegerrequired

Team ID

Example: team_id=60
seasonintegerrequired

Season year

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

Responses

Successful team statistics response

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

Pagination info if applicable

Example: null
errorsobject or null
Example: null
responseobject or null
Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "form": "WWWWWWWDDDDWW",
    "fixtures": { … },
    "goals": { … },
    "biggest": { … },
    "clean_sheet": { … },
    "failed_to_score": { … },
    "lineups": [ … ],
    "penalty": { … },
    "cards": { … }
  }
}

Players

Players

Operations

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations

Odds

Odds

Operations