As football fans, we’d like to organize our schedule so that we don’t miss any of our favorite team’s games. Api-Football can supply us with upcoming football fixtures to assist us in staying on track. And it’s not only limited to the future fixtures; we can also get information about prior and current games.

Parameters	Type	Category	Description
`id`	Integer	Optional	This is the ID of the fixture.
`live`	String	Optional	The value of this parameter will be `all` if we want the stats of all live fixtures and will be the ID of the league if we want to retrieve stats for some specific league.
`date`	String	Optional	This is the date of the fixture we want to see. The format is "YYYY-MM-DD."
`league`	Integer	Optional	~~~~This is the ID of the league we want fixtures from. This ID can be obtained using the Leagues endpoint.
`season`	Integer	Optional	This is the year we want to see the fixtures for. The format is "YYYY."
`team`	Integer	Optional	This is the ID of the team we want fixtures for. This ID can be obtained using the Teams information endpoint.
`last`	Integer	Optional	This indicates the number of past fixtures we want to see the stats for. It should be a two-digit integer.
`next`	Integer	Optional	This indicates the number of future fixtures we want to see the information for. It should be a two-digit integer.
`from`	String	Optional	This is the date we want the fixtures' data to begin from. The format is "YYYY-MM-DD."
`to`	String	Optional	This is the termination date for the fixtures' data. The format is "YYYY-MM-DD."
`round`	String	Optional	This is the round number of the fixture we want to see the stats for. The number of rounds can be obtained from the Rounds endpoint as explained in the "Support Endpoints" lesson of the Appendix.
`status`	String	Optional	This indicates the status of the fixtures.
`timezone`	String	Optional	This is the time zone we want to see the fixtures for. Valid time zones can be obtained using the Timezone endpoint as explained in the "Support Endpoints" lesson of the Appendix.

Press + to interact

const date = new Date();
const endpointUrl = new URL('https://v3.football.api-sports.io/fixtures');
const queryParameters = new URLSearchParams({
  team: '33', // 33 is the team id for Manchester United
  season: date.getFullYear()
});
headerParameters = {
  'x-rapidapi-host': 'v3.football.api-sports.io',
  'x-rapidapi-key': '{{API_KEY}}'
}
const options = {
  method: 'GET',
  headers: headerParameters
};
async function fetchTeamFixtures() {
  try {
    endpointUrl.search = queryParameters;
    const response = await fetch(endpointUrl, options);
    printResponse(response);
  } 
  catch (error) {
    printError(error);
  }
}
fetchTeamFixtures();

Here is a brief code explanation:

Line 2: We set the URL to https://v3.football.api-sports.io/fixtures.
Lines 4–12: We define the query parameters and header parameters. We can get fixtures for other teams by changing the team ID in line 5.
Lines 14–17: We set the request type and appropriate header.
Lines 19–28: We define a function, fetchTeamFixtures(). It calls the endpoint and prints the response.

Note: The team ID can be retrieved using the Teams information endpoint, as explained in Teams Information lesson.

Press + to interact

const endpointUrl = new URL('https://v3.football.api-sports.io/fixtures');
const queryParameters = new URLSearchParams({
  live: 'all'
});
headerParameters = {
  'x-rapidapi-host': 'v3.football.api-sports.io',
  'x-rapidapi-key': '{{API_KEY}}'
}
const options = {
  method: 'GET',
  headers: headerParameters
};
async function fetchLiveFixtures() {
  try {
    endpointUrl.search = queryParameters;
    const response = await fetch(endpointUrl, options);
    printResponse(response);
  } 
  catch (error) {
    printError(error);
  }
}
fetchLiveFixtures();

Response fields	Type	Description
`fixture`	Object	This object contains information like ID, date, and time of the fixtures.
`league`	Object	This object contains information about the league in which the fixture has been scheduled.
`teams`	Object	This object contains information about the ID, name, and a link for the logo of the teams participating in the fixture.
`goals`	Object	This object contains information about the goals scored in the fixture.
`score`	Object	This object contains information about the goals scored at half-time, full-time, extra-time, and the goals scored in penalties.

Introduction

Teams

Fixtures

Players

Widgets

APIs Integration in React

Conclusion

Appendix

Fixtures Information

Retrieve a list of fixtures

Request parameters

Response fields