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

Get match

Request

Returns full information for a single match by its ID.

Security
bearerAuth
Query
idintegerrequired

Match ID

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

Responses

Detailed match data

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 match

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

Get matches

Request

Returns a paginated list of matches based on filters

Security
bearerAuth
Query
league_idinteger

ID of the league

Example: league_id=618
seasoninteger

Season

Example: season=2024
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

Short match status code. Possible values:

    • TBD: Scheduled but date and time are not known
    • NS: Match is scheduled and has not started
    • 1H: First half is in progress
    • HT: Match is at halftime
    • 2H: Second half is in progress
    • ET: Extra time is being played
    • BT: Break during extra time
    • P: Penalty shootout is in progress
    • SUSP: Suspended by referee’s decision, may be rescheduled
    • INT: Match interrupted temporarily, should resume shortly
    • FT: Match finished in regular time
    • AET: Match finished after extra time
    • PEN: Match finished after penalties
    • PST: Postponed to a later date
    • CANC: Cancelled and will not be played
    • ABD: Abandoned before completion (e.g., weather, safety)
    • AWD: Technical loss awarded (not played)
    • WO: WalkOver — opponent forfeited
    • LIVE: In progress but detailed timing not available
Enum"TBD""NS""1H""HT""2H""ET""BT""P""SUSP""INT"
Example: status=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?league_id=618&season=2024&team_id=0&date=string&date_from=string&date_to=string&live=string&status=FT&id_list=string&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Paginated response with Match 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": {
    "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.

Security
bearerAuth
Query
idintegerrequired

Match ID

Example: id=372452
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/match-events?id=372452' \
  -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.

Security
bearerAuth
Query
idintegerrequired

Match ID

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

Responses

List of match statistics

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

Pagination info if applicable

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

Match statistics broken down by home and away teams

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "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.

Security
bearerAuth
Query
idintegerrequired

Match ID

Example: id=372452
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/match-lineup?id=372452' \
  -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.

Security
bearerAuth
Query
team_id1integerrequired

First team ID

Example: team_id1=60
team_id2integerrequired

Second team ID

Example: team_id2=69
league_idinteger

Optional league ID filter

Example: league_id=618
seasoninteger

Optional season filter

curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/head-to-head?team_id1=60&team_id2=69&league_id=618&season=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

Odds

Odds

Operations