Matches
API Endpoint: Get Live Football Matches
Purpose
This endpoint retrieves the current live football matches along with their tournament details. It provides real-time information about ongoing matches, including team scores and tournament specifics.
Request Format
Method: GET
URL:
https://apiv3.sportsapi360.com/football/api/v1/matches/liveRequest Body: This endpoint does not require a request body.
Response Structure
The response from this endpoint will be in JSON format and includes the following key components:
status: A boolean indicating the success of the request.
statusCode: An integer representing the status code of the response.
message: A string for any additional message related to the response.
response: An array containing details of live matches. Each match object includes:
tournamentId: The unique identifier for the tournament.
tournament: An object containing tournament details:
id: The unique identifier for the tournament.
name: The name of the tournament.
category: An object with category details including:
name: The name of the category.
id: The unique identifier for the category.
country: An object with country details including:
alpha2: The two-letter country code.
alpha3: The three-letter country code.
name: The name of the country.
details: Additional tournament details including:
name: The name of the tournament.
category: The category details.
hasPerformanceGraphFeature: A boolean indicating if performance graphs are available.
id: The unique identifier for the details.
country: Country details.
hasEventPlayerStatistics: A boolean indicating if player statistics are available.
displayInverseHomeAwayTeams: A boolean indicating if home and away teams are displayed inversely.
matches: An array of match objects, each containing:
tournamentId: The unique identifier for the tournament.
id: The unique identifier for the match.
startTimestamp: The start time of the match in timestamp format.
detailId: The detail identifier for the match.
season: An object with season details including:
name: The name of the season.
year: The year of the season.
id: The unique identifier for the season.
roundInfo: An object containing round information.
status: An object with status details including:
code: Status code.
description: Description of the status.
type: Type of status.
statusTime: An object detailing the status time.
homeTeam: An object containing details of the home team.
homeScore: An object with the current score of the home team.
awayTeam: An object containing details of the away team.
awayScore: An object with the current score of the away team.
time: An object detailing the match time.
tournament: An object with tournament details (similar to the tournament object above).
This structure allows clients to easily parse and display live match information, facilitating real-time updates for users.
OK
GET /football/api/v1/matches/live HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"tournamentId": 52,
"tournament": {
"id": 52,
"name": "Liga Portugal Betclic",
"category": {
"name": "Portugal",
"id": 44,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
},
"flag": "portugal",
"alpha2": "PT"
},
"details": {
"name": "Liga Portugal Betclic",
"category": {
"name": "Portugal",
"id": 44,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
},
"flag": "portugal",
"alpha2": "PT"
},
"hasPerformanceGraphFeature": true,
"id": 238,
"country": {},
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
},
"matches": [
{
"tournamentId": 52,
"id": 14131866,
"startTimestamp": 1754841600,
"detailId": 1,
"season": {
"name": "Liga Portugal 25/26",
"year": "25/26",
"id": 77806
},
"roundInfo": {
"round": 1
},
"status": {
"code": 7,
"description": "2nd half",
"type": "inprogress"
},
"statusTime": {
"prefix": "",
"initial": 2700,
"max": 5400,
"timestamp": 1754845829,
"extra": 540
},
"homeTeam": {
"name": "Famalicão",
"shortName": "Famalicão",
"gender": "M",
"nameCode": "FAM",
"disabled": false,
"national": false,
"type": 0,
"id": 49531,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
},
"subTeams": []
},
"homeScore": {
"current": 3,
"display": 3,
"period1": 2,
"period2": 1,
"normaltime": 3
},
"awayTeam": {
"name": "Santa Clara",
"shortName": "Santa Clara",
"gender": "M",
"nameCode": "SCL",
"disabled": false,
"national": false,
"type": 0,
"id": 3011,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
},
"subTeams": []
},
"awayScore": {
"current": 0,
"display": 0,
"period1": 0,
"period2": 0,
"normaltime": 0
},
"time": {
"injuryTime1": 3,
"initial": 2700,
"max": 5400,
"extra": 540,
"currentPeriodStartTimestamp": 1754845829
},
"tournament": {
"id": 52,
"name": "Liga Portugal Betclic",
"category": {
"name": "Portugal",
"id": 44,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
},
"flag": "portugal",
"alpha2": "PT"
},
"details": {
"name": "Liga Portugal Betclic",
"category": {
"name": "Portugal",
"id": 44,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
},
"flag": "portugal",
"alpha2": "PT"
},
"hasPerformanceGraphFeature": true,
"id": 238,
"country": {},
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
}
}
]
}
]
}Get Match Schedule
This endpoint retrieves the scheduled matches for a specific date in the football tournament calendar. The request allows users to specify a date to fetch all matches scheduled for that day.
Request
Method: GET
URL:
https://apiv3.sportsapi360.com/football/api/v1/matches/scheduleQuery Parameters:
date(string, required): The date for which the match schedule is requested, formatted asYYYY-MM-DD.
Response Structure
The response will return a JSON object containing the following fields:
status(boolean): Indicates if the request was successful.statusCode(integer): A code representing the status of the response.message(string): A message providing additional information about the request status.response(array): An array of match schedules, where each match object includes:tournamentId(integer): The ID of the tournament.tournament(object): Details about the tournament, including:id(integer): Tournament ID.name(string): Name of the tournament.category(object): Category details including:name(string): Name of the category.id(integer): Category ID.country(object): Country details including:alpha2(string): Alpha-2 country code.alpha3(string): Alpha-3 country code.name(string): Name of the country.
flag(string): URL or path to the country flag.
matches(array): An array of match objects, where each match includes:id(integer): Unique match ID.startTimestamp(integer): The start time of the match in UNIX timestamp format.homeTeam(object): Details about the home team, including:name(string): Team name.shortName(string): Short name of the team.gender(string): Gender category of the team.country(object): Country details of the team.
homeScore(object): Current score and breakdown of the home team's scoring.awayTeam(object): Details about the away team, structured similarly tohomeTeam.awayScore(object): Current score and breakdown of the away team's scoring.time(object): Timing details including injury time.tournament(object): Tournament details associated with the match.
Example Response
{
"status": true,
"statusCode": 0,
"message": "",
"response": [
{
"tournamentId": 0,
"tournament": {
"id": 0,
"name": "",
"category": {
"name": "",
"id": 0,
"country": {
"alpha2": "",
"alpha3": "",
"name": ""
},
"flag": "",
"alpha2": ""
},
"details": {
"name": "",
"category": {
"name": "",
"id": 0,
"country": {
"alpha2": "",
"alpha3": "",
"name": ""
},
"flag": "",
"alpha2": ""
},
"hasPerformanceGraphFeature": true,
"id": 0,
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": true
}
},
"matches": [
{
"tournamentId": 0,
"id": 0,
"startTimestamp": 0,
"homeTeam": {
"name": "",
"shortName": "",
"gender": "",
"country": {
"alpha2": "",
"alpha3": "",
"name": ""
}
},
"homeScore": {
"current": 0,
"display": 0
},
"awayTeam": {
"name": "",
"shortName": "",
"gender": "",
"country": {
"alpha2": "",
"alpha3": "",
"name": ""
}
},
"awayScore": {
"current": 0,
"display": 0
},
"time": {
"injuryTime1": 0,
"injuryTime2": 0
}
}
]
}
]
}
2025-08-10OK
GET /football/api/v1/matches/schedule HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"tournamentId": 1307,
"tournament": {
"id": 1307,
"name": "Community Shield",
"category": {
"name": "England",
"id": 1,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
},
"flag": "england",
"alpha2": "EN"
},
"details": {
"name": "Community Shield",
"category": {
"name": "England",
"id": 1,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
},
"flag": "england",
"alpha2": "EN"
},
"hasPerformanceGraphFeature": false,
"id": 346,
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
},
"matches": [
{
"tournamentId": 1307,
"id": 14038670,
"startTimestamp": 1754834400,
"detailId": 1,
"season": {
"name": "Community Shield 2025",
"year": "2025",
"id": 77151
},
"roundInfo": {
"round": 29,
"name": "Final",
"cupRoundType": 1
},
"status": {
"code": 120,
"description": "AP",
"type": "finished"
},
"homeTeam": {
"name": "Crystal Palace",
"shortName": "Crystal Palace",
"gender": "M",
"nameCode": "CRY",
"disabled": false,
"national": false,
"type": 0,
"id": 7,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
},
"subTeams": []
},
"homeScore": {
"current": 5,
"display": 2,
"period1": 1,
"period2": 1,
"normaltime": 2,
"penalties": 3
},
"awayTeam": {
"name": "Liverpool",
"shortName": "Liverpool",
"gender": "M",
"nameCode": "LIV",
"disabled": false,
"national": false,
"type": 0,
"id": 44,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
},
"subTeams": []
},
"awayScore": {
"current": 4,
"display": 2,
"period1": 2,
"period2": 0,
"normaltime": 2,
"penalties": 2
},
"time": {
"injuryTime1": 7,
"injuryTime2": 5,
"currentPeriodStartTimestamp": 1754838677
},
"tournament": {
"id": 1307,
"name": "Community Shield",
"category": {
"name": "England",
"id": 1,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
},
"flag": "england",
"alpha2": "EN"
},
"details": {
"name": "Community Shield",
"category": {
"name": "England",
"id": 1,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
},
"flag": "england",
"alpha2": "EN"
},
"hasPerformanceGraphFeature": false,
"id": 346,
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
}
}
]
}
]
}Last updated