Participants

In general, the participants include provides additional information about the participants involved in a specific fixture. Including the participants in your request allows you to retrieve detailed information about each team like the name, image and which team won a fixture.

How to use this include

You can use the participants include by adding the &include= parameter and setting it to participants to retrieve this information. For a GET Fixture by ID request, that would look like this:

Request

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

Response

        "participants": [
            {
                "id": 20,
                "sport_id": 1,
                "country_id": 462,
                "venue_id": 449,
                "gender": "male",
                "name": "Newcastle United",
                "short_code": "NEW",
                "image_path": "https://cdn.sportmonks.com/images/soccer/teams/20/20.png",
                "founded": 1892,
                "type": "domestic",
                "placeholder": false,
                "last_played_at": "2024-04-13 11:30:00",
                "meta": {
                    "location": "home",
                    "winner": false,
                    "position": 8
                }
            },
            {
                "id": 13,
                "sport_id": 1,
                "country_id": 462,
                "venue_id": 12,
                "gender": "male",
                "name": "Everton",
                "short_code": "EVE",
                "image_path": "https://cdn.sportmonks.com/images/soccer/teams/13/13.png",
                "founded": 1878,
                "type": "domestic",
                "placeholder": false,
                "last_played_at": "2024-04-15 19:00:00",
                "meta": {
                    "location": "away",
                    "winner": false,
                    "position": 16
                }
            }
        ]
    },

Understanding the response

As you can see in the response tab above; each team is represented as an object with the following attributes:

• id: Unique identifier for the team.

• sport_id: Identifier for the sport.

• country_id: Identifier for the country the team belongs to.

• venue_id: Identifier for the venue where the team plays its home matches.

• gender: Gender category.

• name: Name of the team.

• short_code: Short code or abbreviation for the team name.

• image_path: URL to the team's logo or image.

• founded: Year the team was founded.

• type: Type of team.

• placeholder: Indicates if the team is a placeholder or not.

• last_played_at: Date and time of the team's last match.

In the "meta" section you can find additional data about that team related to the fixture.

• location: Indicates if the team is the home or away side.

• winner: Indicates if the team has won the match or not. If the match hasn't finished yet this will be set to null.

• position: Indicates the position in the standings for that team.

Other include options

In addition to the participants include, you can use nested includes to retrieve even more detailed data. You can find more information about our nested includes on this page. The following include are used the most for participants:

• participants.upcoming which gives the upcoming fixtures for each team.

• participants.latest which gives the past fixtures for each team.

• participants.sidelined which gives all the injured and suspended players for each team.

• participants.coaches which gives the coaches for each team.