Matches

Live Matches

get

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/live

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

Authorizations

apikeyAuth

HTTPRequired

Header parameters

x-api-keystringOptional

Responses

200

OK

text/plain

Responsestring

get

/football/api/v1/matches/live

HTTPcURLJavaScriptPython

GET /football/api/v1/matches/live HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

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
                        }
                    }
                }
            ]
        }
    ]
}

Scheduled Matches

get

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/schedule

• Query Parameters:

  • date (string, required): The date for which the match schedule is requested, formatted as YYYY-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 to homeTeam.

    • 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
          }
        }
      ]
    }
  ]
}

Authorizations

apikeyAuth

HTTPRequired

Query parameters

datestringOptionalExample: 2025-08-10

Header parameters

x-api-keystringOptional

Responses

200

OK

text/plain

Responsestring

get

/football/api/v1/matches/schedule

HTTPcURLJavaScriptPython

GET /football/api/v1/matches/schedule HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

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
                        }
                    }
                }
            ]
        }
    ]
}