Series Data API

Series Matches

get

Get Matches for a Cricket Series

This endpoint retrieves the list of matches associated with a specific cricket series identified by the seriesId.

Request

  • Method: GET

  • Endpoint: https://apiv3.sportsapi360.com/cricket/api/v2/series/:seriesId/matches

Path Parameters

  • seriesId: The unique identifier for the cricket series for which the matches are being requested.

Response Format

The response will be a JSON array containing match details with the following structure:

  • isAbandoned: Boolean indicating if the match was abandoned.

  • matchName: Name of the match.

  • homeTeamShortName: Short name of the home team.

  • awayTeamShortName: Short name of the away team.

  • matchResult: Result of the match.

  • venue: Venue where the match is held.

  • winningTeamID: ID of the winning team.

  • matchNumber: Number assigned to the match.

  • matchdate: Date of the match.

  • matchID: Unique identifier for the match.

  • matchStatus: Current status of the match.

  • startDate: Scheduled start date of the match.

  • matchLevel: Level of the match (e.g., international, domestic).

  • matchType: Type of the match (e.g., Test, ODI, T20).

  • statusMessage: Message indicating the current status of the match.

  • playing11Status: Boolean indicating if the playing XI has been announced.

  • probable11Status: Boolean indicating if the probable XI has been announced.

  • playerOfTheMatch: Name of the player of the match.

  • playerOfTheMatchDetails: Object containing details about the player of the match.

  • teamsWinProbability: Object containing win probabilities for both teams and tie percentage.

  • matchScore: Array of score details for each team in the match.

This endpoint is useful for obtaining detailed information about the matches in a cricket series, including their status and scores.

Authorizations
HTTPRequired
Path parameters
seriesIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/series/{seriesId}/matches
200

OK

Series Point Table

get

Get the Point Table for the Cricket Series

This endpoint retrieves the point table for a specific cricket series identified by seriesId.

Request

  • Method: GET

  • Endpoint: https://apiv3.sportsapi360.com/cricket/api/v2/series/:seriesId/point-table

  • Path Parameters:

    • seriesId (required): The unique identifier for the cricket series whose point table you want to fetch.

Response

The response will be in JSON format and includes the following structure:

  • name: A string representing the name of the series.

  • teams: An array of team objects, each containing:

    • pos: The position of the team in the point table (integer).

    • teamID: The unique identifier for the team (string).

    • teamName: The full name of the team (string).

    • teamShortName: The abbreviated name of the team (string).

    • all: Total matches played by the team (string).

    • wins: Total matches won by the team (string).

    • qp: Total matches that resulted in a qualified position (string).

    • lost: Total matches lost by the team (string).

    • points: Total points accumulated by the team (string).

    • nrr: Net Run Rate of the team (string).

    • noResult: Total matches with no result (string).

    • isQualified: A boolean indicating whether the team has qualified for the next stage.

Authorizations
HTTPRequired
Path parameters
seriesIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/series/{seriesId}/point-table
200

OK

Series Squads

get

Get Cricket Series Squads

This endpoint retrieves the squads for a specific cricket series identified by the seriesId.

Request

  • Method: GET

  • Endpoint: https://apiv3.sportsapi360.com/cricket/api/v2/series/:seriesId/squads

  • Path Parameters:

    • seriesId (string): The unique identifier for the cricket series whose squads are being requested.

Response

The response will be in JSON format and includes the following key components:

  • isNewSeries (boolean): Indicates whether the series is new.

  • displayFormats (array of strings): Contains the formats in which the series is displayed.

  • squadData (array): An array of squad information, where each squad includes:

    • teamID (string): The unique identifier for the team.

    • name (string): The name of the team.

    • squad (array): Contains details about the squad members, where each member includes:

      • matchType (string): The type of match.

      • playersArray (array): An array of player details, where each player includes:

        • playerID (string): The unique identifier for the player.

        • iswk (boolean): Indicates if the player is a wicketkeeper.

        • iscap (boolean): Indicates if the player is a captain.

        • playerRole (string): The role of the player in the team.

        • playerName (string): The name of the player.

This structure provides a comprehensive overview of the squads participating in the specified cricket series.

Authorizations
HTTPRequired
Path parameters
seriesIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/series/{seriesId}/squads
200

OK

Series Statics

get

Get Cricket Series Statistics

This endpoint retrieves the statistics for a specific cricket series identified by the seriesId. It provides detailed information about the series, including various performance metrics and statistics relevant to the matches played within that series.

Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/cricket/api/v2/series/:seriesId/statics

Path Parameters

  • seriesId (required): The unique identifier for the cricket series whose statistics are being requested.

Response

The response will contain a detailed JSON object with statistics related to the specified series. The structure of the response may include various metrics such as match results, player performances, and other relevant data points.

Expected Response Format

  • Status Code: 200 OK (if the request is successful)

  • Content-Type: application/json

Important Notes

  • Ensure that the seriesId is valid and corresponds to an existing cricket series in the database.

  • The response may vary based on the availability of data for the requested series.

  • Handle potential errors gracefully, such as invalid seriesId or server issues, which may return appropriate error codes (e.g., 404 Not Found, 500 Internal Server Error).

Authorizations
HTTPRequired
Path parameters
seriesIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/series/{seriesId}/statics
200

OK

Series Stadiums

get

Get Stadiums by Series ID

This endpoint retrieves a list of stadiums associated with a specific cricket series identified by the seriesId.

Request Method

GET

Endpoint

https://apiv3.sportsapi360.com/cricket/api/v2/series/:seriesId/stadiums

Path Parameters

  • seriesId (string): The unique identifier for the cricket series for which you want to fetch the associated stadiums.

Expected Response Format

The response will be in JSON format and includes the following fields:

  • status (boolean): Indicates the success of the request.

  • statusCode (integer): A code representing the status of the response.

  • message (string): A message providing additional information about the response.

  • response (array): An array of stadium objects, each containing:

    • stadiumName (string): The name of the stadium.

    • capacity (string): The seating capacity of the stadium.

    • city (string): The city where the stadium is located.

    • venueId (string): The unique identifier for the stadium.

Example Response

This endpoint is useful for applications that require information about stadiums for a particular cricket series, allowing users to view venue details and capacities.

Authorizations
HTTPRequired
Path parameters
seriesIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/series/{seriesId}/stadiums
200

OK

Last updated