:tid (Path Parameter): The unique identifier for the tournament you want to retrieve information for. This should be replaced with the actual tournament ID.
Response Fields
status: Indicates the success of the request.
statusCode: A numerical code representing the status of the response.
message: Additional information about the response.
response: Contains detailed information about the competition, including:
name: Name of the competition.
category: Details about the category of the competition.
titleHolder: Information about the current title holder.
mostTitlesTeams: Teams with the most titles in the competition.
seasons: List of seasons associated with the competition.
featuredMatch: Details of featured matches within the competition.
This endpoint provides comprehensive details about a specific football competition, including its structure, title holders, historical data, and current season information.
Authorizations
HTTPRequired
Path parameters
tidintegerRequiredExample: 7
Header parameters
x-api-keystringOptional
Responses
200
OK
text/plain
Responsestring
get
/football/api/v1/competitions/{tid}
200
OK
Competition Featured
get
Endpoint Description
This endpoint retrieves featured matches for a specific tournament in the football API. It allows users to access detailed information about ongoing or upcoming matches within a specified tournament.
:tid (required): The unique identifier for the tournament. This parameter specifies which tournament's featured matches are being requested.
Expected Response
The response will return a JSON object containing the following structure:
status: A boolean indicating the success of the request.
statusCode: An integer representing the status code of the response.
message: A string providing additional information about the request status (if any).
response: An array of featured match objects, each containing:
tournamentId: The ID of the tournament.
id: The unique ID of the match.
startTimestamp: The start time of the match in Unix timestamp format.
detailId: An identifier for detailed match information.
season: An object containing:
name: The name of the season.
year: The year of the season.
id: The ID of the season.
roundInfo: An object providing details about the round:
round: The round number.
name: The name of the round.
status: An object with match status details:
code: The status code.
description: A textual description of the status.
type: The type of status.
homeTeam: An object containing details about the home team, including:
name: The name of the team.
shortName: The abbreviated name of the team.
gender: The gender category of the team.
nameCode: The code used for the team's name.
disabled: A boolean indicating if the team is disabled.
national: A boolean indicating if the team is a national team.
type: The type of team (e.g., club, national).
id: The unique ID of the team.
country: An object containing country details.
subTeams: An array of sub-teams, if applicable.
homeScore: An object containing aggregated score information for the home team.
awayTeam: Similar structure as homeTeam, but for the away team.
awayScore: An object containing aggregated score information for the away team.
time: An object with timing information for the match.
tournament: An object containing tournament details, including:
id: The ID of the tournament.
name: The name of the tournament.
category: An object with category details.
details: An object with additional tournament details.
Additional Notes
Ensure that the :tid parameter is correctly replaced with a valid tournament ID to receive the appropriate data.
The response may include multiple featured matches, depending on the tournament and its scheduling.
Authorizations
HTTPRequired
Path parameters
tidintegerRequiredExample: 7
Header parameters
x-api-keystringOptional
Responses
200
OK
text/plain
Responsestring
get
/football/api/v1/competitions/{tid}/featured
200
OK
Competition Season Info
get
Endpoint Description
This endpoint retrieves detailed information about a specific football competition for a given season. It allows users to access various statistics related to the competition, including team performance metrics.
This endpoint retrieves a list of matches for a specific tournament and season in the football API. It provides detailed information about each match, including team details, scores, and tournament information.
Request
HTTP Method: GET
Endpoint:https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/matches
Path Parameters
:tid (Tournament ID): The unique identifier for the tournament.
:sid (Season ID): The unique identifier for the season within the tournament.
Response
The response will return a JSON object containing the following structure:
status (boolean): Indicates the success of the request.
statusCode (integer): A code representing the status of the request.
message (string): A message providing additional information about the request.
response (array): An array of match objects, each containing:
tournamentId (integer): The ID of the tournament.
id (integer): The unique identifier for the match.
startTimestamp (integer): The start time of the match in timestamp format.
detailId (integer): An identifier for match details.
season (object): Contains season information including:
name (string): The name of the season.
year (string): The year of the season.
seasonCoverageInfo (object): Additional coverage information for the season.
id (integer): The unique identifier for the season.
roundInfo (object): Information about the round of the match including:
round (integer): The round number.
name (string): The name of the round.
status (object): Current status of the match including:
code (integer): Status code.
description (string): Description of the status.
type (string): Type of status.
homeTeam (object): Details of the home team including:
This endpoint retrieves the standings for a specific tournament and season in football. It provides detailed information about the teams participating in the tournament, including their performance metrics.
:tid (string): The unique identifier for the football competition.
:sid (string): The unique identifier for the season of the competition.
Expected Response Format
On a successful request, the API will return a JSON object containing the top players for the specified competition and season. The response will include details such as player names, positions, and performance statistics.
This endpoint retrieves a list of top teams for a specified competition and season. It is useful for obtaining insights into the performance of teams within a particular league or tournament.
This API endpoint retrieves the matches for a specific round of a tournament in a given season. It provides detailed information about each match, including team details, scores, and tournament information.
