Matches

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

Get match

Request

Returns full information for a single match by its ID.

Query
idintegerrequired

Match ID

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

Responses

Detailed match data

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

Pagination info if applicable

errorsobject or null
Example: null
responseobject or null

Detailed information about a match

Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": {
    "0": {},
    "id": 1234,
    "league_id": 5,
    "home_team_id": 10,
    "away_team_id": 12,
    "timestamp": 1713261600,
    "timezone": "UTC",
    "date": "2025-04-16T15:00:00Z",
    "referee": "John Doe",
    "venue_id": 3,
    "round": "Round 5",
    "group": "Group A",
    "season": "2024/2025",
    "periods": { … },
    "status": { … },
    "score": { … },
    "events": [ … ],
    "statistics": [ … ]
  }
}

Get matches

Request

Returns a paginated list of matches based on filters

Query
league_idinteger

ID of the league

seasoninteger

Season

team_idinteger

ID of the team

datestring<= 10 characters

Exact match date (YYYY-MM-DD)

date_fromstring<= 10 characters

Start date for match range (YYYY-MM-DD)

date_tostring<= 10 characters

End date for match range (YYYY-MM-DD)

livestring

Filter by live matches, all or several leagues ids: example of values ('all', '1-2-3')

statusstring

Status of the match (NS, FT)

id_liststring

Comma-separated list of match IDs

pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/matches?date=string&date_from=string&date_to=string&id_list=string&league_id=0&live=string&page=1&season=0&status=string&team_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Paginated response with Match items

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

Pagination details for paginated responses

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 match events

Request

Returns a list of events (goals, cards, substitutions, etc.) for a given match.

Query
idintegerrequired

Match ID

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

Responses

List of match events

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

Request

Returns match statistics (shots, possession, fouls, etc.) for a given match.

Query
idintegerrequired

Match ID

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

Responses

List of match statistics

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

Pagination info if applicable

errorsobject or null
Example: null
responseobject or null

Match statistics broken down by home and away teams

Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": {
    "0": {},
    "shots_on_goal": { … },
    "shots_off_goal": { … },
    "total_shots": { … },
    "blocked_shots": { … },
    "shots_inside_box": { … },
    "shots_outside_box": { … },
    "fouls": { … },
    "corner_kicks": { … },
    "offsides": { … },
    "ball_possession": { … },
    "yellow_cards": { … },
    "red_cards": { … },
    "goalkeeper_saves": { … },
    "total_passes": { … },
    "passes_accurate": { … },
    "passes_percentage": { … },
    "expected_goals": { … },
    "goals_prevented": { … }
  }
}

Get match lineup

Request

Returns the full lineup for both teams in a given match, including starters, substitutes, and coaches.

Query
idintegerrequired

Match ID

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

Responses

Lineup data for the match

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

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null

Lineup for both teams

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

Get head-to-head

Request

Returns a list of past matches between two teams, optionally filtered by league and season.

Query
team_id1integerrequired

First team ID

team_id2integerrequired

Second team ID

league_idinteger

Optional league ID filter

seasoninteger

Optional season filter

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/head-to-head?league_id=0&season=0&team_id1=0&team_id2=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of head-to-head matches

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

Teams

Teams

Operations

Players

Players

Operations

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations