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:

https://api.sportmonks.com/v3/football/fixtures/{fixture_ID}&include=scores

What does it look like?

When you use scores for a regular match that is finished, you'll only get three different types of scores: 1st half, 2nd half 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 World Cup 2022 final below:

Scores example World Cup 2022 Final: Argentina - France

    "scores": [
      {
        "id": 10902600,
        "fixture_id": 18452325,
        "type_id": 1,
        "participant_id": 18647,
        "score": {
          "goals": 0,
          "participant": "away"
        },
        "description": "1ST_HALF"
      },
      {
        "id": 10902601,
        "fixture_id": 18452325,
        "type_id": 1,
        "participant_id": 18644,
        "score": {
          "goals": 2,
          "participant": "home"
        },
        "description": "1ST_HALF"
      },
      {
        "id": 10902602,
        "fixture_id": 18452325,
        "type_id": 2,
        "participant_id": 18647,
        "score": {
          "goals": 2,
          "participant": "away"
        },
        "description": "2ND_HALF"
      },
      {
        "id": 10902603,
        "fixture_id": 18452325,
        "type_id": 2,
        "participant_id": 18644,
        "score": {
          "goals": 2,
          "participant": "home"
        },
        "description": "2ND_HALF"
      },
      {
        "id": 10902604,
        "fixture_id": 18452325,
        "type_id": 3,
        "participant_id": 18647,
        "score": {
          "goals": 1,
          "participant": "away"
        },
        "description": "ET"
      },
      {
        "id": 10902605,
        "fixture_id": 18452325,
        "type_id": 3,
        "participant_id": 18644,
        "score": {
          "goals": 1,
          "participant": "home"
        },
        "description": "ET"
      },
      {
        "id": 10902608,
        "fixture_id": 18452325,
        "type_id": 1525,
        "participant_id": 18647,
        "score": {
          "goals": 3,
          "participant": "away"
        },
        "description": "CURRENT"
      },
      {
        "id": 10902609,
        "fixture_id": 18452325,
        "type_id": 1525,
        "participant_id": 18644,
        "score": {
          "goals": 3,
          "participant": "home"
        },
        "description": "CURRENT"
      },
      {
        "id": 10902607,
        "fixture_id": 18452325,
        "type_id": 5,
        "participant_id": 18644,
        "score": {
          "goals": 4,
          "participant": "home"
        },
        "description": "PENALTY_SHOOTOUT"
      },
      {
        "id": 10902606,
        "fixture_id": 18452325,
        "type_id": 5,
        "participant_id": 18647,
        "score": {
          "goals": 2,
          "participant": "away"
        },
        "description": "PENALTY_SHOOTOUT"
      }
    ]
  },

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: the score for both teams in the 2nd half only.

• 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.