Matches List API

Match Schedule (v3)

get

Get Cricket Match Schedule

This endpoint makes an HTTP GET request to retrieve the schedule of cricket matches.

Request

• Endpoint: https://apiv3.sportsapi360.com/cricket/api/v3/match/schedule

• Query Parameters:

  • type (string, required): Type of matches to retrieve (e.g. All)

  • page (integer, required): Page number for pagination (e.g. 0)

Response

• Status: 200

• Content-Type: application/json

• Body:

  • An array of objects, each containing match details such as match ID, date, series ID, teams, match status, venue, match result, player of the match, match score, and more.

Authorizations

apikeyAuth

HTTPRequired

Query parameters

typestringOptional

All,International,Domestic,Leagues,Women

Example: All

pageintegerOptional

-999 to 999

Example: 0

Header parameters

x-api-keystringOptionalExample: {API_KEY}

Responses

200

OK

application/json

Responseobject

get

/cricket/api/v3/match/schedule

HTTPcURLJavaScriptPython

GET /cricket/api/v3/match/schedule HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

OK

[
  {
    "title": "13 Jun 2025",
    "data": [
      {
        "matchID": "256863",
        "matchdate": "Fri, 13 Jun 2025 23:30:00 GMT",
        "seriesID": "7159",
        "tourID": "7159",
        "winningTeamID": null,
        "currentinningsNo": "2",
        "currentInningteamID": "1186",
        "currentInningsTeamName": "Sussex",
        "seriesName": "T20 Blast, 2025",
        "homeTeamName": "SUS",
        "awayTeamName": "ESS",
        "toss": "Sussex won the toss and elected to field",
        "matchStatus": "completed",
        "matchType": "T20",
        "statusMessage": "Match Abandoned",
        "matchNumber": "Match 49",
        "venue": " Hove",
        "matchResult": "Match Abandoned",
        "startDate": "1749857400000",
        "playerOfTheMatch": "",
        "playerofTheMatchTeamShortName": "",
        "firstInningsTeamID": "282",
        "secondInningsTeamID": "1186",
        "thirdInningsTeamID": "",
        "fourthInningsTeamID": "",
        "teamsWinProbability": {
          "homeTeamShortName": "",
          "homeTeamPercentage": "",
          "awayTeamShortName": "",
          "awayTeamPercentage": "",
          "tiePercentage": ""
        },
        "matchScore": [
          {
            "teamShortName": "ESS",
            "teamID": "282",
            "teamFullName": "Essex",
            "teamScore": [
              {
                "inning": 1,
                "inningNumber": "First",
                "battingTeam": "Essex",
                "runsScored": "177",
                "wickets": "4",
                "overs": "17.0",
                "runRate": "10.41",
                "battingSide": "away",
                "teamID": "282",
                "battingTeamShortName": "ESS",
                "declared": false,
                "folowOn": false
              }
            ]
          },
          {
            "teamShortName": "SUS",
            "teamID": "1186",
            "teamFullName": "Sussex",
            "teamScore": [
              {
                "inning": 2,
                "inningNumber": "Second",
                "battingTeam": "Sussex",
                "runsScored": "23",
                "wickets": "3",
                "overs": "3.1",
                "runRate": "7.26",
                "battingSide": "home",
                "teamID": "1186",
                "battingTeamShortName": "SUS",
                "declared": false,
                "folowOn": false
              }
            ]
          }
        ],
        "isAbandoned": true,
        "matchName": "Match 49, T20 Blast, 2025",
        "homeTeamID": "1186",
        "awayTeamID": "282",
        "matchDateTimeGMT": "1749857400000",
        "win": null,
        "playerOfTheMatchdDetails": {
          "batsmanTab": false,
          "bowlerTab": false,
          "playerID": null,
          "playerTeamID": null,
          "playerName": null,
          "batsman": [],
          "bowler": []
        },
        "superOver": false,
        "coverageLevel": "6",
        "matchLevel": "domestic"
      }
    ]
  }
]

Featured Matches

get

Retrieve Featured Cricket Matches

This endpoint makes an HTTP GET request to retrieve the details of featured cricket matches.

Request

• Endpoint: https://apiv3.sportsapi360.com/cricket/api/v2/match/featured

Response

• Status: 200

• Content-Type: application/json

• Body:

  • The response contains an array of objects, each representing a featured match. Each object includes details such as display feature match scorecard, match abandonment status, home match update, series ID, current innings details, match status, match type, venue, match result, start date, player of the match, match score, and more.

Authorizations

apikeyAuth

HTTPRequired

Header parameters

x-api-keystringOptionalExample: {API_KEY}

Responses

200

OK

application/json

Responseobject

get

/cricket/api/v2/match/featured

HTTPcURLJavaScriptPython

GET /cricket/api/v2/match/featured HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

OK

[
  {
    "displayFeatureMatchScoreCard": true,
    "isAbandoned": false,
    "isHomeMatchUpade": false,
    "seriesID": "7197",
    "currentinningsNo": "4",
    "currentInningteamID": "7",
    "currentInningsTeamName": "South Africa",
    "seriesName": "ICC World Test Championship Final, 2025",
    "homeTeamName": "SA",
    "awayTeamName": "AUS",
    "toss": "South Africa won the toss and elected to field",
    "matchName": "Final, ICC World Test Championship Final, 2025",
    "startEndDate": null,
    "matchStatus": "live",
    "matchID": "255314",
    "matchType": "Test",
    "statusMessage": "Day 3: Stumps - SA need 69 runs",
    "phaseOfInningFlag": false,
    "matchNumber": "Final",
    "venue": " London",
    "matchResult": "",
    "startDate": "1749654000000",
    "playerOfTheMatch": "",
    "playerofTheMatchTeamShortName": null,
    "playing11Status": true,
    "probable11Status": false,
    "playerID": "",
    "winningTeamID": null,
    "firstInningsTeamID": "1",
    "secondInningsTeamID": "7",
    "thirdInningsTeamID": "1",
    "playerOfTheMatchdDetails": {
      "batsmanTab": false,
      "playerID": null,
      "playerName": null,
      "playerTeamID": null
    },
    "teamsWinProbability": {
      "homeTeamShortName": "",
      "homeTeamPercentage": "",
      "awayTeamShortName": "",
      "awayTeamPercentage": "",
      "tiePercentage": ""
    },
    "fourthInningsTeamID": "7",
    "matchScore": [
      {
        "teamShortName": "AUS",
        "teamID": "1",
        "teamFullName": "Australia",
        "teamScore": [
          {
            "inning": 1,
            "inningNumber": "First",
            "battingTeam": "Australia",
            "runsScored": "212",
            "wickets": "10",
            "overs": "56.4",
            "runRate": "3.74",
            "battingSide": "away",
            "teamID": "1",
            "battingTeamShortName": "AUS",
            "declared": false,
            "folowOn": false
          },
          {
            "inning": 3,
            "inningNumber": "Third",
            "battingTeam": "Australia",
            "runsScored": "207",
            "wickets": "10",
            "overs": "65.0",
            "runRate": "3.18",
            "battingSide": "away",
            "teamID": "1",
            "battingTeamShortName": "AUS",
            "declared": false,
            "folowOn": false
          }
        ]
      },
      {
        "teamShortName": "SA",
        "teamID": "7",
        "teamFullName": "South Africa",
        "teamScore": [
          {
            "inning": 2,
            "inningNumber": "Second",
            "battingTeam": "South Africa",
            "runsScored": "138",
            "wickets": "10",
            "overs": "57.1",
            "runRate": "2.41",
            "battingSide": "home",
            "teamID": "7",
            "battingTeamShortName": "SA",
            "declared": false,
            "folowOn": false
          },
          {
            "inning": 4,
            "inningNumber": "Fourth",
            "battingTeam": "South Africa",
            "runsScored": "213",
            "wickets": "2",
            "overs": "56.0",
            "runRate": "3.80",
            "battingSide": "home",
            "teamID": "7",
            "battingTeamShortName": "SA",
            "declared": false,
            "folowOn": false
          }
        ]
      }
    ],
    "currentDay": 3,
    "currentSession": 3
  }
]

Match Schedule

get

Get Cricket Match Schedule

This endpoint makes an HTTP GET request to retrieve the schedule of cricket matches.

Request

• Endpoint: https://apiv3.sportsapi360.com/cricket/api/v2/match/schedule

• Query Parameters:

  • type (string, required): Type of matches to retrieve (e.g. All)

  • page (integer, required): Page number for pagination (e.g. 0)

Response

• Status: 200

• Content-Type: application/json

• Body:

  • An array of objects, each containing match details such as match ID, date, series ID, teams, match status, venue, match result, player of the match, match score, and more.

Authorizations

apikeyAuth

HTTPRequired

Query parameters

statusstringOptional

completed, upcoming, live

Example: live

typestringOptional

all, international, domestic, t20, women

Example: all

pageintegerOptional

-999 to 999

Example: 0

Header parameters

x-api-keystringOptionalExample: {API_KEY}

Responses

200

OK

application/json

Responseobject

get

/cricket/api/v2/match/schedule

HTTPcURLJavaScriptPython

GET /cricket/api/v2/match/schedule HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

OK

[
  {
    "seriesAvailable": false,
    "seriesID": "7197",
    "matchType": "Test",
    "seriesName": "ICC World Test Championship Final, 2025",
    "type": "international",
    "matches": [
      {
        "isAbandoned": false,
        "isHomeMatchUpade": false,
        "seriesID": "7197",
        "league": "International",
        "currentinningsNo": "4",
        "currentInningsTeamName": "South Africa",
        "seriesName": "ICC World Test Championship Final, 2025",
        "homeTeamName": "SA",
        "awayTeamName": "AUS",
        "toss": "South Africa won the toss and elected to field",
        "startEndDate": null,
        "matchStatus": "live",
        "matchID": "255314",
        "matchType": "Test",
        "statusMessage": "Day 3: Stumps - SA need 69 runs",
        "matchNumber": "Final",
        "venue": " London",
        "matchResult": "",
        "playerOfTheMatchdDetails": {
          "batsmanTab": false,
          "playerID": null,
          "playerTeamID": null
        },
        "teamsWinProbability": {
          "homeTeamShortName": "",
          "homeTeamPercentage": "",
          "awayTeamShortName": "",
          "awayTeamPercentage": "",
          "tiePercentage": ""
        },
        "matchScore": [
          {
            "teamShortName": "AUS",
            "teamID": "1",
            "teamFullName": "Australia",
            "teamScore": [
              {
                "inning": 1,
                "inningNumber": "First",
                "battingTeam": "Australia",
                "runsScored": "212",
                "wickets": "10",
                "overs": "56.4",
                "runRate": "3.74",
                "battingSide": "away",
                "teamID": "1",
                "battingTeamShortName": "AUS",
                "declared": false,
                "folowOn": false
              },
              {
                "inning": 3,
                "inningNumber": "Third",
                "battingTeam": "Australia",
                "runsScored": "207",
                "wickets": "10",
                "overs": "65.0",
                "runRate": "3.18",
                "battingSide": "away",
                "teamID": "1",
                "battingTeamShortName": "AUS",
                "declared": false,
                "folowOn": false
              }
            ]
          },
          {
            "teamShortName": "SA",
            "teamID": "7",
            "teamFullName": "South Africa",
            "teamScore": [
              {
                "inning": 2,
                "inningNumber": "Second",
                "battingTeam": "South Africa",
                "runsScored": "138",
                "wickets": "10",
                "overs": "57.1",
                "runRate": "2.41",
                "battingSide": "home",
                "teamID": "7",
                "battingTeamShortName": "SA",
                "declared": false,
                "folowOn": false
              },
              {
                "inning": 4,
                "inningNumber": "Fourth",
                "battingTeam": "South Africa",
                "runsScored": "213",
                "wickets": "2",
                "overs": "56.0",
                "runRate": "3.80",
                "battingSide": "home",
                "teamID": "7",
                "battingTeamShortName": "SA",
                "declared": false,
                "folowOn": false
              }
            ]
          }
        ],
        "startDate": "1749654000000",
        "playerID": "",
        "winningTeamID": null,
        "playing11Status": true,
        "probable11Status": true,
        "playerOfTheMatch": "",
        "playerofTheMatchTeamShortName": "",
        "firstInningsTeamID": "1",
        "secondInningsTeamID": "7",
        "thirdInningsTeamID": "1",
        "fourthInningsTeamID": "7"
      }
    ]
  }
]