Skip to main content

Tournament APIs

Source: https://www.cricketapi.com/v5/docs/tournament-*-rest-api

Overview​

Tournament endpoints provide access to tournament details, fixtures, points tables, and team squads.

Endpoints​

GET /v5/cricket/{project_key}/featured-tournaments/

Returns a curated list of high-demand tournaments.

Tournament Details​

GET /v5/cricket/{project_key}/tournament/{tournament_key}/

Returns comprehensive tournament information including format, dates, teams, and status.

Tournament Fixtures​

GET /v5/cricket/{project_key}/tournament/{tournament_key}/fixtures/

Returns all matches for a specific tournament.

Tournament Points Table​

GET /v5/cricket/{project_key}/tournament/{tournament_key}/points/

Returns the points table (league standings) for a tournament.

Tournament Team​

GET /v5/cricket/{project_key}/tournament/{tournament_key}/team/{team_key}/

Returns team squad and details for a specific tournament.

Headers (all endpoints)​

rs-token: <access_token>

Sample Requests (Node.js)​

// Tournament details
const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/tournament/${tournamentKey}/`,
  { headers: { 'rs-token': token } }
);

// Tournament fixtures
const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/tournament/${tournamentKey}/fixtures/`,
  { headers: { 'rs-token': token } }
);

// Points table
const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/tournament/${tournamentKey}/points/`,
  { headers: { 'rs-token': token } }
);

// Team squad
const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/tournament/${tournamentKey}/team/${teamKey}/`,
  { headers: { 'rs-token': token } }
);

Response Structures​

{
  "data": {
    "tournaments": {
      "<tournament_key>": {
        "key": "ipl_2026",
        "name": "Indian Premier League 2026",
        "short_name": "IPL 2026",
        "association": { "key": "bcci", "name": "BCCI" },
        "format": "t20i",
        "status": "in_progress",
        "start_date": 1711234567,
        "end_date": 1713826567,
        "teams_count": 10,
        "matches_count": 74
      }
    }
  }
}

Points Table​

{
  "data": {
    "groups": {
      "default": {
        "teams": [
          {
            "team": { "key": "csk", "name": "Chennai Super Kings" },
            "played": 10,
            "won": 7,
            "lost": 3,
            "no_result": 0,
            "points": 14,
            "nrr": 0.845
          }
        ]
      }
    }
  }
}

Team Squad​

{
  "data": {
    "team": {
      "key": "csk",
      "name": "Chennai Super Kings",
      "players": {
        "<player_key>": {
          "player_key": "c__player__ms_dhoni__abc12",
          "name": "MS Dhoni",
          "role": "wicket_keeper_batsman",
          "batting_style": "right_handed",
          "bowling_style": "right_arm_medium"
        }
      }
    }
  }
}

Hannibal Usage​

Not currently used. High value for:

  • Points table display — IPL/tournament standings in cricket section
  • Team squads — Player lists for AI analysis and player prop markets
  • Tournament navigation — Browse matches by tournament
  • Tournament fixtures — More targeted than global fixtures endpoint