Scores
The scores include allows you to retrieve information about the scores within a football match from both participants, the home and away teams. Including the scores in your API requests allows you to retrieve detailed information about the 1st half, 2nd half, Extra Time, Penalty and Current scores.
How to use the include
You can use the scores include by adding the &include= parameter and setting it to scores to retrieve this information. For a GET Fixture by ID request, that would look like this:
What does it look like?
When you use scores for a regular match that is finished, you'll only get four different types of scores: 1st half, 2nd half, 2nd half only, and Current. If the match goes into Extra Time or Penalties, two new scores will be shown in the response: Extra Time and Penalties. Look at the example of the Euro 2024 quarter-final below:
Fields
The "id" field in the response serves as a unique identifier for each score, while the"fixture_id" corresponds to the associated fixture. The "type_id" field indicates the type of the score. The “participant_id” field indicates the team_id from the home or away team. The “score” field shows the amount of goals per participant; home or away. The “description” field corresponds to the specific period a score relates to and provides a textual description.
Type of scores
1st half: the score for both teams in the 1st half only.
2nd half only: the score for both teams in the 2nd half only.
2nd half: the score for both teams at the end of the 2nd half.
Extra Time: the score for both teams in Extra Time.
Penalties: the penalty scores for both teams.
Current: the current score if a fixture is inplay or the final score after FT or ET when a fixture is finished.
Extra include options
scores.type
This include allows you to access more data about the specific type.
scores.participant
This include allows you to access more information about the participating team.
Last updated
Was this helpful?